Appget review get

amg-spicysoft edited this page May 27, 2013 · 5 revisions

レビュー情報 (GET review/get)

全Androidゲームレビューの全項目のデータ。

概要

URL http://appget.com/android-api/<version>/review/get.<format>
内容 指定したレビューのレビュー全データを返す
対応バージョン 1~3
対応フォーマット json,rss,csv
対応リクエスト形式 HTTP/GET
要認証 不要
アクセス制限 なし

要求

対応バージョン 変数名 必須 値形式(定義値/範囲) 意味(例)
共通 callback × 文字列(半角英数字および"_" “.”) JSONPのコールバック関数名(フォーマットjson指定時に有効)
共通 app_id レビューID(10000~999999) 表示したいレビューを指定するID

応答(正常)

対応バージョン 変数名 値形式(定義値/範囲) 意味(例)
共通 app_id 数値(10000~999999) アプリID
共通 title_ja 文字列 アプリタイトル(日本語名)
共通 title_local 文字列 アプリタイトル(元言語名)※存在する場合のみ
共通 copy 文字列(8文字~40文字) コピー文
共通 language ISO識別子(ja,en等) 配信言語
共通 genre_id 整数 ジャンルID
共通 genre_name_full 文字列(3文字~16文字) ジャンル名フル表記(例:アクション)
共通 genre_name_abb 文字列(3文字~16文字) ジャンル名省略表記(例:ACT)
共通 is_free 真偽値 無料かどうか
共通 price_label 文字列 "無料"または"有料" 無料、有料のテキスト表示
共通 price_label_icon URL 無料、有料のアイコン画像(http://….)
共通 yen_price 整数(円) (有料の場合のみ)日本円換算額
共通 is_yen 真偽値 (有料の場合のみ)価格は円建てかどうか?
共通 currency 文字列(1文字~) (有料&円建てではない場合のみ)通貨単位(例:$)
共通 local_price 浮動小数点 (有料&円建てではない場合のみ)現地通貨での価格
共通 icon_thumb URL アイコン画像(60px×60px) (http://….)
共通 icon URL アイコン画像(120px×120px) (http://….)
2 main_banner_thumb URL バナー画像(縦横のうち長辺が480px) (http://….)
2 main_banner URL バナー画像(縦横のうち長辺が800px) (http://….)
共通 link_to URL レビュー紹介ページへのリンク(http://….)
共通 link_to_qr URL レビュー紹介ページURLのQRコード(120px×120px) (https://….)
共通 developer_ja 文字列 デベロッパー名(日本語)
共通 developer_local 文字列 デベロッパー名(元言語名) ※存在する場合のみ
共通 reviewed_at ISO 8601(YYYY-MM-DD) レビューした日付
共通 published_at ISO 8601(YYYY-MM-DD) (値がある場合) アプリが公開された日付
共通 is_on_delivery 真偽値 現在もそのアプリは公開されているかどうか
共通 review_rating_score 数値(小数点第1位まで表示)0.0~5.0 レビュー評価点
共通 review_rating_score_icon URL スターアイコン画像(http://….)
共通 main_reviewer_name 文字列(1文字~9文字) レビューした人の名前(例:クーニン剛志)
共通 review_device 文字列 レビューした端末(例:Xperia arc)
1 dialogues レビュワー会話の配列 レビュワー会話(ゲームの良い点、悪い点)(0~3件)
2 prologue レビュワー会話の配列 レビュワー会話(ゲームの良い点、悪い点)(1~3件)
共通 screen_shots スクリーンショットの配列 スクリーンショット(1~5件)
共通 introductions ゲーム紹介の配列 ゲーム紹介(1~3件)
共通 points ゲームのポイントの配列 ゲームのポイント(1~8件)
2 evaluate 評価項目の配列 ゲームの独自評価(1~5件)
2 good 良い点の配列 良い点(1~5件)
2 bad 悪い点の配列 悪い点(1~5件)
2 epilogue ビュワー会話の配列 レビュワー会話(終了トーク)(0~3件)
共通 next 次/前のレビュー情報 次のレビューの情報 ※存在する場合のみ
共通 prev 次/前のレビュー情報 前のレビューの情報 ※存在する場合のみ

レビュワー会話(ゲームの良い点、悪い点)の定義

各API共通で使われる応答データの定義を参照して下さい。

スクリーンショットの定義

対応バージョン 変数名 値形式(定義値/範囲) 意味(例)
共通 order 表示順番(1~3) 表示の優先順位
共通 caption 文字列(5~50文字) 画像の補足文
2 comment 文字列(5~300文字) 記事文(HTMLタグ適用箇所)
共通 screen_url_thumb URL ゲーム画像(縦横のうち長辺が480px) (http://….)
共通 screen_url URL ゲーム画像(縦横のうち長辺が800px) (http://….)

ゲーム紹介の定義

対応バージョン 変数名 値形式(定義値/範囲) 意味(例)
共通 order 表示順番(1~3) 表示の優先順位
共通 introduction 文字列(30~300文字) ゲーム説明文(HTMLタグ適用箇所)

ゲームのポイントの定義

対応バージョン 変数名 値形式(定義値/範囲) 意味(例)
共通 order 表示順番(1~5) 表示の優先順位
共通 comment 文字列(5~500文字) 記事文(HTMLタグ適用箇所)
共通 is_image 真偽値 ゲーム画像があるかないか
共通 point_url_thumb URL ゲーム画像(縦横のうち長辺が480px) (http://….)
共通 point_url URL ゲーム画像(縦横のうち長辺が800px) (http://….)
2 point_faceshot_thumb URL レビュワーアイコン画像(60px×60px) (http://….)
2 point_faceshot URL レビュワーアイコン画像(180px×180px) (http://….)
2 caption 文字列(5~40文字) 画像の補足文
2 lead 文字列(5~50文字) リード文

次/前のレビュー情報

対応バージョン 変数名 値形式(定義値/範囲) 意味(例)
共通 app_id 数値(10000~999999) 次もしくは前のレビューのID
共通 link_to URL 次もしくは前のレビュー情報ページへのURL
共通 title_ja 文字列 アプリタイトル(日本語名)
共通 copy 文字列(8文字~40文字) コピー文
共通 icon_thumb URL アイコン画像(60px×60px) (http://….)
共通 icon URL アイコン画像(120px×120px) (http://….)
2 main_banner_thumb URL バナー画像(縦横のうち長辺が480px) (http://….)
2 main_banner URL バナー画像(縦横のうち長辺が800px) (http://….)

HTMLタグ

「HTMLタグ適用箇所」と記載されている文字列値は以下のHTMLタグが出力に含まれる。このタグは要求に tag=No を追加することによりオフにできる。

対応バージョン タグ 意味
共通 <span class="emphasis_text1"></span> 強調1
共通 <span class="emphasis_text2"></span> 強調2
共通 <br /> 改行
2 <p></p> 段落
2 <a href="URL"></a> リンク

その他の応答データの定義はこちらから

応答(異常)

要求に誤りがあった場合は 404を返答する