DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Shopping 商品タスクの設定
keyword の Google Shopping 検索をキューに登録し、タスク id を返します。location_code、language_code、se_domain、depth が検索の形を決めます。この系列は全体が非同期です。送信すると tasks[0].id にタスク id が返り、フェッチツールは準備ができ次第結果を返します。get_dataforseo_merchant_google_products_fetch で取得します。
料金の参考情報
- 計量方式:報告されたレスポンスコスト。
- 参考リクエスト見積もり:0.012 USD。
- 参照用の顧客乗数:1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- depth型: integer | null
- keyword型: string
- language型: string
_code 言語コード
language_nameを指定しない場合は必須フィールド
このフィールドを使用する場合、language_nameを指定する必要はありません
別途https://api.dataforseo.com/v3/merchant/google/languagesにリクエストを送信すると、利用可能な Google Shopping の言語とそのlanguage_codeの一覧を取得できます
例:en - language型: string
_name 言語の正式名称
language_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、language_codeを指定する必要はありません
別途https://api.dataforseo.com/v3/merchant/google/languagesにリクエストを送信すると、利用可能な Google Shopping の言語とそのlanguage_nameの一覧を取得できます
例:English - location型: integer
_code ロケーションコード
location_nameまたはlocation_coordinateを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameまたはlocation_coordinateを指定する必要はありません
別途https://api.dataforseo.com/v3/merchant/google/locationsにリクエストを送信すると、利用可能な Google Shopping のロケーションとそのlocation_codeの一覧を取得できます
例:2840 - 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にリクエストを送信すると、利用可能な Google Shopping のロケーションとそのlocation_nameの一覧を取得できます
例:London,England,United Kingdom - max型: integer | null
_crawl _pages - pingback型: string | null
_url 完了したタスクの通知 URL
任意フィールド
タスクが完了すると、指定した URL に GET リクエストを送信して通知します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストを送信する前に必要な値を設定します。
例:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
注意:pingback_urlの特殊文字は URL エンコードされます;
たとえば、#文字は%23にエンコードされます - postback型: string
_data postback_url のデータ型
postback_urlを指定する場合は必須フィールド
サーバーに送信されるデータ型に対応します
指定可能な値:advanced、html - postback型: string | null
_url タスク結果を送信する URL
任意フィールド
タスクが完了すると、その結果をgzip形式で圧縮し、指定したpostback_urlに POST リクエストで送信します
‘$id’ 文字列を$id変数として、‘$tag’ を URL エンコードされた$tag変数として使用できます。リクエストを送信する前に必要な値を設定します。
例:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
注意:postback_urlの特殊文字は URL エンコードされます;
たとえば、#文字は%23にエンコードされます - price型: integer | null
_max 製品の最高価格
任意フィールド
指定したクエリに対して Google Shopping に掲載されている返却製品の最高価格
例:100
注意:price_maxを指定すると、search_paramパラメーターは無視されます - price型: integer | null
_min 製品の最低価格
任意フィールド
指定したクエリに対して Google Shopping に掲載されている返却製品の最低価格
例:5
注意:price_minを指定すると、search_paramパラメーターは無視されます - priority型: integer | null
- se型: string | null
_domain 検索エンジンのドメイン
任意フィールド
指定したロケーションと言語に応じて、関連する検索エンジンのドメインが自動的に選択されます
ただし、このフィールドでカスタムの検索エンジンドメインを設定できます
例:google.co.uk、google.com.au、google.deなど。 - search型: string | null
_param 検索クエリの追加パラメーター
任意フィールド
次の検索 URL パラメーターを使用して検索をカスタマイズできます;
例:&tbs=ppr_min:45– 45 USD を超える価格の製品を検索します;&tbs=ppr_max:50– 50 USD 未満の価格の製品を検索します;&tbs=p_ord:p– 価格の昇順で並べ替えます;&tbs=p_ord:pd– 価格の降順で並べ替えます;&tbs=p_ord:rv– レビュースコアで並べ替えます;&tbs=ppr_max:50,p_ord:rv– レビュースコアで並べ替え、最高価格を 50 USD にします;&udm=28– 新しい Google Shopping マークアップを使用し、デフォルトで 40 件の SERP 結果を返します(1 つの SERP のコストがそれに応じて差し引かれます);depthの最大値は 200 です;このパラメーターは、urlにtbm=shopを付けずに指定する必要があります;&shoprs=$value– 新しい Shopping マークアップで高度なフィルタリングと並べ替えを指定します;$valueを protobuf Base64 形式の文字列に置き換えてください;詳細はヘルプセンターをご覧ください。
注意:次のいずれかのパラメーターを使用すると、search_paramの値は無視されます:price_min、price_max、sort_by - sort型: string | null
_by 結果の並べ替えルール
任意フィールド
次の並べ替えルールがサポートされています:review_score、price_low_to_high、price_high_to_low
例:sort_by:"review_score"
注意:sort_byを指定すると、search_paramパラメーターは無視されます - tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdataオブジェクトに含まれます - url型: string | null
検索クエリの直接 URL
任意フィールド
直接 URL を指定すると、必要なフィールドに振り分けられます。この方法は API にとって最も処理が難しく、URL に正確な言語とロケーションを指定する必要があることに注意してください。ほとんどの場合、この方法はお勧めしません。
例:https://www.google.com/search?q=fish&hl=en&gl=US&gws_rd=cr&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc
- 型: object | null · Response36Afe1097B20_MerchantGoogleProductsTaskPostResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト(USD)
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_MerchantGoogleProductsTaskPostTaskInfo
- cost型: number | null 形式: double
タスクの総コスト(USD)
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: object | null
結果の配列
この場合、値はnullになります - result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間(秒)
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間(秒)
- 型: string | nullversion
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/products/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "iphone",
"price_min": 5
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}