# Google Shopping レビュータスクの設定 **API:** Data API **Endpoint:** `POST /v1/beta/dataforseo/merchant/google/reviews/task_post` **Tags:** DataForSEO 1 つの Google Shopping 商品のレビューをキューに登録し、タスク `id` を返します。`product_id` と、商品結果の `gid` または `data_docid` で商品を特定します。この系列は全体が非同期です。送信すると `tasks[0].id` にタスク `id` が返り、フェッチツールは準備ができ次第結果を返します。`get_dataforseo_merchant_google_reviews_fetch` で取得します。 ### 料金の参考情報 - 計量方式：報告されたレスポンスコスト。 - 参考リクエスト見積もり：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`) ## Request body Required: **yes** ### application/json Schema: ```json { "type": "array", "items": { "type": "object", "properties": { "gid": { "type": "string", "description": "Google Shopping のグローバル製品識別子 必須フィールド 最適な結果を得るには、gid を data_docid および product_id と一緒に指定することをお勧めします； 特定の製品のこの値は、別途 Google Shopping Products エンドポイントにリクエストを送信して取得できます 例：4702526954592161872 このパラメーターの詳細については、こちらのヘルプセンターガイドを参照してください" }, "product_id": { "type": "string", "description": "Google Shopping の一意の商品識別子 任意フィールド 最適な結果を得るには、product_id を data_docid および gid とともに指定することをお勧めします。特定の商品のこの値は、Google Shopping Products エンドポイントに個別にリクエストして取得できます。例：4485466949985702538 このパラメーターの詳細については、こちらのヘルプセンターガイドを参照してください" }, "data_docid": { "type": "string", "description": "SERP データ要素の一意の識別子 任意フィールド 最適な結果を得るには、data_docid を product_id および gid と一緒に指定することをお勧めします； 特定の要素のこの値は、別途 Google Shopping Products エンドポイントにリクエストを送信して取得できます 例：13071766526042404278" }, "priority": { "type": "integer", "description": "タスクの優先度 任意フィールド 次の値を指定できます：1 – 通常の実行優先度（デフォルト設定）、2 – 高い実行優先度。実行優先度が高いタスクには追加料金が発生します。コストは料金ページで計算できます。" }, "location_name": { "type": "string", "description": "検索エンジンのロケーションの正式名称 location_code または location_coordinate を指定しない場合は必須フィールド このフィールドを使用する場合、location_code または location_coordinate を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/locations にリクエストを送信すると、利用可能なロケーションとその location_name パラメーターの一覧を取得できます 例：HA1,England,United Kingdom" }, "location_code": { "type": "integer", "description": "検索エンジンのロケーションコード location_name または location_coordinate を指定しない場合は必須フィールド このフィールドを使用する場合、location_name または location_coordinate を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/locations にリクエストを送信すると、利用可能なロケーションとその location_code パラメーターの一覧を取得できます 例：9045969" }, "location_coordinate": { "type": "string", "description": "ロケーションの GPS 座標 location_name または location_code を指定しない場合は必須フィールド このフィールドを使用する場合、location_name または location_code を指定する必要はありません location_coordinate パラメーターは “latitude,longitude,radius” 形式で指定する必要があります “latitude” と “longitude” の最大小数桁数：7 “radius” の最小値：199.9 例：53.476225,-2.243572,200" }, "language_name": { "type": "string", "description": "検索エンジンの言語の正式名称 language_code を指定しない場合は必須フィールド このフィールドを使用する場合、language_code を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/languages にリクエストを送信すると、利用可能な言語とその language_name パラメーターの一覧を取得できます 例：English (United Kingdom)" }, "language_code": { "type": "string", "description": "検索エンジンの言語コード language_name を指定しない場合は必須フィールド このフィールドを使用する場合、language_name を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/languages にリクエストを送信すると、利用可能な言語とその language_code パラメーターの一覧を取得できます 例：en_GB" }, "se_domain": { "type": "string", "description": "検索エンジンのドメイン 任意フィールド 指定したロケーションと言語に応じて、関連する検索エンジンドメインを自動的に選択します。ただし、このフィールドでカスタムの検索エンジンドメインを設定できます。例：google.co.uk、google.com.au、google.de など" }, "depth": { "type": "integer", "description": "解析深度 任意フィールド SERP のレビュー数；システムは 10 件のレビューを連続して処理するため、解析深度は 10 の倍数に設定することを強くお勧めします；最大値：8000 デフォルト値：10 アカウントには、最大 10 件の結果を含む SERP ごとに課金されます； 深度を 10 以上に設定すると、検索エンジンが 10 件を超える結果を返した場合に追加料金が発生する可能性があります； コストは料金ページで計算できます。" }, "tag": { "type": "string", "description": "ユーザー定義のタスク識別子 任意フィールド 文字数上限は 255 です このパラメーターを使ってタスクを識別し、結果と照合できます 指定した tag の値は、レスポンスの data オブジェクトに含まれます" }, "postback_url": { "type": "string", "description": "タスク結果送信用の URL 任意フィールド タスクが完了すると、結果を gzip 形式で圧縮し、指定した postback_url に POST リクエストを送信します ‘$id’ 文字列を $id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストを送信する前に必要な値を設定します。例：http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag 注意：postback_url 内の特殊文字は URL エンコードされます。たとえば、# 文字は %23 にエンコードされます。詳細については、ヘルプセンターを参照してください" }, "postback_data": { "type": "string", "description": "postback_url のデータ型 任意フィールド サーバーに送信されるデータ型に対応します 可能な値：advanced" }, "pingback_url": { "type": "string", "description": "完了したタスクの通知 URL 任意フィールド タスクが完了すると、指定した URL に GET リクエストを送信して通知します ‘$id’ 文字列を $id 変数として、‘$tag’ を URL エンコードされた $tag 変数として使用できます。リクエストを送信する前に必要な値を設定します。例：http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag 注意：pingback_url 内の特殊文字は URL エンコードされます。たとえば、# 文字は %23 にエンコードされます。詳細については、ヘルプセンターを参照してください" } }, "required": [ "gid" ], "allOf": [ { "anyOf": [ { "required": [ "location_name" ] }, { "required": [ "location_code" ] }, { "required": [ "location_coordinate" ] } ] }, { "anyOf": [ { "required": [ "language_name" ] }, { "required": [ "language_code" ] } ] } ] } } ``` ## Responses ### 200 — 成功レスポンス Headers: - `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。 **application/json** Schema: object ```json { "type": "object", "properties": { "version": { "type": "string", "description": "API の現在のバージョン" }, "status_code": { "type": "integer", "description": "一般的なステータスコード レスポンスコードの完全な一覧はこちらです 注意: 関連する例外やエラー条件を処理するための必要なシステムを設計することを強く推奨します" }, "status_message": { "type": "string", "description": "一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです" }, "time": { "type": "string", "description": "実行時間（秒）" }, "cost": { "type": "number", "description": "タスクの総コスト（USD）" }, "tasks_count": { "type": "integer", "description": "tasks 配列内のタスク数" }, "tasks_error": { "type": "integer", "description": "エラーで返された tasks 配列内のタスク数" }, "tasks": { "type": "array", "items": { "type": "string" }, "description": "タスクの配列" }, "tasks.id": { "type": "string", "description": "当社システム内のタスクの一意の識別子（UUID 形式）" }, "tasks.status_code": { "type": "integer", "description": "DataForSEO によって生成されたタスクのステータスコード。10000〜60000 の範囲です" }, "tasks.status_message": { "type": "string", "description": "タスクの情報メッセージ" }, "tasks.time": { "type": "string", "description": "実行時間（秒）" }, "tasks.cost": { "type": "number", "description": "タスクのコスト（USD）" }, "tasks.result_count": { "type": "integer", "description": "result 配列内の要素数" }, "tasks.path": { "type": "array", "items": { "type": "string" }, "description": "URL パス" }, "tasks.data": { "type": "object", "description": "POST リクエストで指定したものと同じパラメーターを含みます" }, "tasks.result": { "type": "array", "items": { "type": "string" }, "description": "結果配列 この場合、値は null になります" } } } ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ```