# id で Business Data Google Extended Reviews の結果を取得 **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/business_data/google/extended_reviews/task_get/{id}` **Tags:** DataForSEO `id` で、ビジネスの Google レビュー履歴全体をキューから取得します。標準エンドポイントが返す最初のページより先まで取得できます。DataForSEO のエンベロープ構造です。データは `tasks[0].result`、結果ステータスは `tasks[0].status_code` に格納され、拒否されたリクエストでも HTTP 200 が返ります。⚠️ サイズは送信時に設定した深さに比例し、ここでは絞り込めません。 ### 料金の参考情報 - 計量方式：レスポンスで報告されるコスト。 - 参考リクエスト見積もり：0.012 USD。 - 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。 参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。 ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `id` | path | yes | string | タスク識別子
当社システム内で UUID 形式の一意のタスク識別子
30 日以内であれば、いつでもこれを使ってタスクの結果をリクエストできます | ## Responses ### 200 — 操作成功 Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: object | null ```json { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo" } ] } ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### Response36Afe1097B20_AiModeImagesElementInfo `#/components/schemas/Response36Afe1097B20_AiModeImagesElementInfo` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "alt": { "type": [ "string", "null" ], "description": "画像の alt タグ" }, "url": { "type": [ "string", "null" ], "description": "関連 URL" }, "image_url": { "type": [ "string", "null" ], "description": "画像の URL
元のリソースまたは DataForSEO ストレージ内の画像への URL（元のソースが利用できない場合）" } } } ``` ### Response36Afe1097B20_BaseResponseInfo `#/components/schemas/Response36Afe1097B20_BaseResponseInfo` ```json { "properties": { "version": { "type": [ "string", "null" ], "description": "API の現在のバージョン" }, "status_code": { "type": [ "integer", "null" ], "description": "一般的なステータスコード\nレスポンスコードの完全な一覧はこちらです" }, "status_message": { "type": [ "string", "null" ], "description": "一般的な情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": [ "string", "null" ], "description": "合計実行時間（秒）" }, "cost": { "type": [ "number", "null" ], "description": "タスクの総コスト（USD）", "format": "double" }, "tasks_count": { "type": [ "integer", "null" ], "description": "tasks 配列内のタスク数", "format": "int64" }, "tasks_error": { "type": [ "integer", "null" ], "description": "エラーで返された tasks 配列内のタスク数", "format": "int64" } } } ``` ### Response36Afe1097B20_BaseResponseTaskInfo `#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo` ```json { "properties": { "id": { "type": [ "string", "null" ], "description": "タスク識別子\n当社システム内で UUID 形式の一意のタスク識別子" }, "status_code": { "type": [ "integer", "null" ], "description": "タスクのステータスコード\nDataForSEO によって生成され、次の範囲の値になります: 10000-60000\nレスポンスコードの完全な一覧はこちらです" }, "status_message": { "type": [ "string", "null" ], "description": "タスクの情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": [ "string", "null" ], "description": "実行時間（秒）" }, "cost": { "type": [ "number", "null" ], "description": "タスクの総コスト（USD）", "format": "double" }, "result_count": { "type": [ "integer", "null" ], "description": "result 配列内の要素数", "format": "int64" }, "path": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "URL パス" }, "data": { "type": [ "object", "null" ], "additionalProperties": { "type": [ "object", "null" ] }, "description": "POST リクエストで指定したものと同じパラメーターを含みます" } } } ``` ### Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResponseInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo" }, { "type": "object", "properties": { "tasks": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo" } ] }, "description": "タスクの配列" } } } ] } ``` ### Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResultInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResultInfo` ```json { "type": "object", "properties": { "keyword": { "type": [ "string", "null" ], "description": "POST 配列で受信したキーワード
キーワードはデコードされた %## で返されます（プラス文字 '+' はスペース文字にデコードされます）" }, "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "se_domain": { "type": [ "string", "null" ], "description": "POST 配列内の検索エンジンドメイン" }, "location_code": { "type": [ "integer", "null" ], "description": "POST 配列内のロケーションコード" }, "language_code": { "type": [ "string", "null" ], "description": "POST 配列内の言語コード" }, "check_url": { "type": [ "string", "null" ], "description": "検索エンジン結果への直接 URL
正確な結果が提供されていることを確認するために使用できます" }, "datetime": { "type": [ "string", "null" ], "description": "結果を受信した日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：
2019-11-15 12:57:46 +00:00" }, "title": { "type": [ "string", "null" ], "description": "SERP の「reviews」要素のタイトル
レビューの収集対象である地域の施設の名前" }, "sub_title": { "type": [ "string", "null" ], "description": "SERP の「reviews」要素のサブタイトル
レビューの収集対象である「reviews」要素に関する追加情報（住所など）" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo" } ], "description": "対応する地域の施設の評価
レビューに基づき SERP に表示される人気度" }, "feature_id": { "type": [ "string", "null" ], "description": "SERP の「reviews」要素の一意の識別子
識別子の詳細については、このヘルプセンター記事をご覧ください" }, "place_id": { "type": [ "string", "null" ], "description": "Google が割り当てたビジネス拠点の一意の識別子
識別子の詳細については、このヘルプセンター記事をご覧ください" }, "cid": { "type": [ "string", "null" ], "description": "Google 定義のクライアント ID
地域の施設の一意の ID
識別子の詳細については、このヘルプセンター記事をご覧ください" }, "reviews_count": { "type": [ "integer", "null" ], "description": "レビューの総数", "format": "int64" }, "items_count": { "type": [ "integer", "null" ], "description": "結果配列内のレビュー項目数
タスク設定時に depth パラメータを使用すると、より多くの結果を取得できます", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_GoogleExtendedReviewsSearch" } ] }, "description": "見つかったレビュー
タスク設定時に depth パラメータを使用すると、より多くの結果を取得できます" } } } ``` ### Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo `#/components/schemas/Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetTaskInfo` ```json { "type": "object", "allOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo" }, { "type": "object", "properties": { "result": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleExtendedReviewsTaskGetResultInfo" } ] }, "description": "結果の配列" } } } ] } ``` ### Response36Afe1097B20_GoogleExtendedReviewsSearch `#/components/schemas/Response36Afe1097B20_GoogleExtendedReviewsSearch` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "rank_group": { "type": [ "integer", "null" ], "description": "type 値が同一の要素グループ内での位置
type 値が異なる要素の位置は rank_group から除外されます" }, "rank_absolute": { "type": [ "integer", "null" ], "description": "一覧表示されたすべてのレビューの中での絶対ランク
リスト内のすべてのレビューの中での絶対位置" }, "position": { "type": [ "string", "null" ], "description": "SERP におけるレビューの配置
次の値を取ります：right" }, "xpath": { "type": [ "string", "null" ], "description": "レビューの XPath" }, "review_text": { "type": [ "string", "null" ], "description": "レビューの内容" }, "original_review_text": { "type": [ "string", "null" ], "description": "レビューの元の内容
レビューの元の内容。自動翻訳は適用されていません" }, "time_ago": { "type": [ "string", "null" ], "description": "公開時刻
レビューが掲載された時刻（「〜前」形式）を示します" }, "timestamp": { "type": [ "string", "null" ], "description": "レビューが公開された日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：
2019-11-15 12:57:46 +00:00" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo" } ], "description": "レビュー投稿者が送信した評価スコア" }, "reviews_count": { "type": [ "integer", "null" ], "description": "レビュー投稿者が送信したレビューの総数", "format": "int64" }, "photos_count": { "type": [ "integer", "null" ], "description": "レビュー投稿者が送信した写真の総数", "format": "int64" }, "local_guide": { "type": [ "boolean", "null" ], "description": "レビュー投稿者が「ローカルガイド」ステータスを持っているかどうかを示します" }, "profile_name": { "type": [ "string", "null" ], "description": "レビュー投稿者のプロフィール名" }, "profile_url": { "type": [ "string", "null" ], "description": "レビュー投稿者のプロフィールの URL" }, "review_url": { "type": [ "string", "null" ], "description": "レビューの URL" }, "profile_image_url": { "type": [ "string", "null" ], "description": "レビュー投稿者のプロフィール画像の URL" }, "owner_answer": { "type": [ "string", "null" ], "description": "オーナーの返信のテキスト
レビューに対するオーナーの返信" }, "original_owner_answer": { "type": [ "string", "null" ], "description": "オーナーの返信の元のテキスト
レビューに対する元の返信。自動翻訳は適用されていません" }, "owner_time_ago": { "type": [ "string", "null" ], "description": "公開時刻
オーナーがレビューへの返信を送信した時刻（「〜前」形式）を示します" }, "owner_timestamp": { "type": [ "string", "null" ], "description": "オーナーがレビューに返信した日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：
2019-11-15 12:57:46 +00:00" }, "review_id": { "type": [ "string", "null" ], "description": "Google におけるレビューの一意の識別子
例：
ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE" }, "images": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_AiModeImagesElementInfo" } ] }, "description": "レビュー投稿者が送信した画像" }, "review_highlights": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ReviewHighlights" } ] }, "description": "レビューのハイライト
強調表示されたレビュー基準と評価を含みます" }, "source": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_Source" } ], "description": "レビューの参照元
レビューが投稿された参照元に関する情報" } } } ``` ### Response36Afe1097B20_RatingInfo `#/components/schemas/Response36Afe1097B20_RatingInfo` ```json { "properties": { "rating_type": { "type": [ "string", "null" ], "description": "評価の種類\nここには次の要素があります：Max5、Percents、CustomMax" }, "value": { "type": [ "number", "null" ], "description": "評価の値", "format": "double" }, "votes_count": { "type": [ "integer", "null" ], "description": "フィードバックの量", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "rating_type の最大値" } } } ``` ### Response36Afe1097B20_ReviewHighlights `#/components/schemas/Response36Afe1097B20_ReviewHighlights` ```json { "type": "object", "properties": { "feature": { "type": [ "string", "null" ], "description": "評価された機能" }, "assessment": { "type": [ "string", "null" ], "description": "機能評価" } } } ``` ### Response36Afe1097B20_Source `#/components/schemas/Response36Afe1097B20_Source` ```json { "type": "object", "properties": { "title": { "type": [ "string", "null" ], "description": "レビューが投稿されたソースの名前" }, "image": { "type": [ "string", "null" ], "description": "ソースのアイキャッチ画像" }, "domain": { "type": [ "string", "null" ], "description": "レビューが投稿されたソースのドメイン" } } } ```