DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Shopping レビュータスクの設定
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 の請求記録に従います。
- 型: array object[]
- 型: object
- gid型: string必須
Google Shopping のグローバル製品識別子 必須フィールド 最適な結果を得るには、gid を data_docid および product_id と一緒に指定することをお勧めします； 特定の製品のこの値は、別途 Google Shopping Products エンドポイントにリクエストを送信して取得できます 例：4702526954592161872 このパラメーターの詳細については、こちらのヘルプセンターガイドを参照してください
- data型: string
_docid SERP データ要素の一意の識別子 任意フィールド 最適な結果を得るには、data_docid を product_id および gid と一緒に指定することをお勧めします； 特定の要素のこの値は、別途 Google Shopping Products エンドポイントにリクエストを送信して取得できます 例：13071766526042404278
- depth型: integer
解析深度 任意フィールド SERP のレビュー数；システムは 10 件のレビューを連続して処理するため、解析深度は 10 の倍数に設定することを強くお勧めします；最大値：8000 デフォルト値：10 アカウントには、最大 10 件の結果を含む SERP ごとに課金されます； 深度を 10 以上に設定すると、検索エンジンが 10 件を超える結果を返した場合に追加料金が発生する可能性があります； コストは料金ページで計算できます。
- language型: string
_code 検索エンジンの言語コード language_name を指定しない場合は必須フィールド このフィールドを使用する場合、language_name を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/languages にリクエストを送信すると、利用可能な言語とその language_code パラメーターの一覧を取得できます 例：en_GB
- language型: string
_name 検索エンジンの言語の正式名称 language_code を指定しない場合は必須フィールド このフィールドを使用する場合、language_code を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/languages にリクエストを送信すると、利用可能な言語とその language_name パラメーターの一覧を取得できます 例：English (United Kingdom)
- location型: integer
_code 検索エンジンのロケーションコード location_name または location_coordinate を指定しない場合は必須フィールド このフィールドを使用する場合、location_name または location_coordinate を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/locations にリクエストを送信すると、利用可能なロケーションとその location_code パラメーターの一覧を取得できます 例：9045969
- location型: string
_coordinate ロケーションの 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
- location型: string
_name 検索エンジンのロケーションの正式名称 location_code または location_coordinate を指定しない場合は必須フィールド このフィールドを使用する場合、location_code または location_coordinate を指定する必要はありません 別途 https://api.dataforseo.com/v3/merchant/google/locations にリクエストを送信すると、利用可能なロケーションとその location_name パラメーターの一覧を取得できます 例：HA1,England,United Kingdom
- pingback型: string
_url 完了したタスクの通知 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 にエンコードされます。詳細については、ヘルプセンターを参照してください
- postback型: string
_data postback_url のデータ型 任意フィールド サーバーに送信されるデータ型に対応します 可能な値：advanced
- postback型: string
_url タスク結果送信用の 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 にエンコードされます。詳細については、ヘルプセンターを参照してください
- priority型: integer
タスクの優先度 任意フィールド 次の値を指定できます：1 – 通常の実行優先度（デフォルト設定）、2 – 高い実行優先度。実行優先度が高いタスクには追加料金が発生します。コストは料金ページで計算できます。
- product型: string
_id Google Shopping の一意の商品識別子 任意フィールド 最適な結果を得るには、product_id を data_docid および gid とともに指定することをお勧めします。特定の商品のこの値は、Google Shopping Products エンドポイントに個別にリクエストして取得できます。例：4485466949985702538 このパラメーターの詳細については、こちらのヘルプセンターガイドを参照してください
- se型: string
_domain 検索エンジンのドメイン 任意フィールド 指定したロケーションと言語に応じて、関連する検索エンジンドメインを自動的に選択します。ただし、このフィールドでカスタムの検索エンジンドメインを設定できます。例：google.co.uk、google.com.au、google.de など
- tag型: string
ユーザー定義のタスク識別子 任意フィールド 文字数上限は 255 です このパラメーターを使ってタスクを識別し、結果と照合できます 指定した tag の値は、レスポンスの data オブジェクトに含まれます
空のオブジェクト空のオブジェクト
- 型: object200
成功レスポンス
- 型: numbercost
タスクの総コスト（USD）
- 型: integerstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです 注意: 関連する例外やエラー条件を処理するための必要なシステムを設計することを強く推奨します
- 型: stringstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array string[]tasks
タスクの配列
- 型: integertasks
_count tasks 配列内のタスク数
- 型: integertasks
_error エラーで返された tasks 配列内のタスク数
- 型: numbertasks
.cost タスクのコスト（USD）
- 型: objecttasks
.data POST リクエストで指定したものと同じパラメーターを含みます
- 型: stringtasks
.id 当社システム内のタスクの一意の識別子（UUID 形式）
- 型: array string[]tasks
.path URL パス
- 型: array string[]tasks
.result 結果配列 この場合、値は null になります
- 型: integertasks
.result _count result 配列内の要素数
- 型: integertasks
.status _code DataForSEO によって生成されたタスクのステータスコード。10000〜60000 の範囲です
- 型: stringtasks
.status _message タスクの情報メッセージ
- 型: stringtasks
.time 実行時間（秒）
- 型: stringtime
実行時間（秒）
- 型: stringversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/merchant/google/reviews/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{},
{}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks.id": "string",
"tasks.status_code": 1,
"tasks.status_message": "string",
"tasks.time": "string",
"tasks.cost": 1,
"tasks.result_count": 1,
"tasks.path": [
"string"
],
"tasks.data": {},
"tasks.result": [
"string"
]
}