# id で Google Shopping 商品情報の結果を取得 **API:** Data API **Endpoint:** `GET /v1/beta/dataforseo/merchant/google/product_info/task_get/advanced/{id}` **Tags:** DataForSEO `post_dataforseo_merchant_google_product_info_submit` でキューに登録したタスクから取得する、1 つの Google Shopping 商品の詳細ページです。仕様、説明、画像、取り扱いセラーを含みます。DataForSEO のエンベロープに包まれます。データは `tasks[0].result`、結果は `tasks[0].status_code` に格納され、拒否されたリクエストでも HTTP 200 が返ります。ここに至る検索結果には `get_dataforseo_merchant_google_products_fetch`、買い手の意見には `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`) ## 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_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo" } ] } ``` ### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。 ### 401 — 有効な Felo API キーが必要です。 ### 402 — 請求要件が満たされていないため、リクエストを続行できません。 ### 403 — このアカウントにはこの操作を行う権限がありません。 ### 429 — リクエストまたは支出の上限に達しました。 ### 502 — サービスがリクエストを完了できませんでした。 ### 503 — API または請求サービスが一時的に利用できません。 ### 504 — リクエストの処理中にサービスがタイムアウトしました。 ### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります **application/json** Schema: ```json {} ``` ## Schema definitions ### 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_DeliveryInfo `#/components/schemas/Response36Afe1097B20_DeliveryInfo` ```json { "type": "object", "properties": { "delivery_date_from": { "type": [ "string", "null" ], "description": "最早配送日
商品を発送できる最早日。UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”
例: 2019-11-15 12:57:46 +00:00" }, "delivery_date_to": { "type": [ "string", "null" ], "description": "最遅配送日
商品を配送できる最遅日。UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”
例: 2019-11-15 12:57:46 +00:00" }, "fastest_delivery_date_from": { "type": [ "string", "null" ], "description": "最早無料配送日
迅速配送オプションを利用した場合に商品を配送できる最早日。UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”
例: 2019-11-15 12:57:46 +00:00" }, "fastest_delivery_date_to": { "type": [ "string", "null" ], "description": "最遅無料配送日
迅速配送オプションを利用した場合に商品を配送できる最遅日。UTC 形式: “yyyy-mm-dd hh-mm-ss +00:00”
例: 2019-11-15 12:57:46 +00:00" }, "delivery_message": { "type": [ "string", "null" ], "description": "配送情報
出品者が配送情報とともに投稿したメッセージ" }, "delivery_price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "配送料金
POST リクエストで指定したロケーションに基づく配送料金
送料無料が利用できる場合、値は null になります" } } } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResponseInfo` ```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_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo" } ] }, "description": "タスクの配列" } } } ] } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedResultInfo` ```json { "type": "object", "properties": { "product_id": { "type": [ "string", "null" ], "description": "POST 配列内の商品 ID
このパラメーターの詳細についてはこちらのヘルプセンター ガイドをご覧ください" }, "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": "結果を受信した日時
形式：“year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”
例：
2019-11-15 12:57:46 +00:00" }, "item_types": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "商品仕様ページで見つかった項目の種類
可能な項目タイプ：
product_info_element" }, "items_count": { "type": [ "integer", "null" ], "description": "items 配列で返された結果数", "format": "int64" }, "items": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductInfoElement" } ] }, "description": "商品ページの項目
商品ページに掲載されているすべての商品属性と関連データを含みます" } } } ``` ### Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo `#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskGetAdvancedTaskInfo` ```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_MerchantGoogleProductInfoTaskGetAdvancedResultInfo" } ] }, "description": "結果の配列" } } } ] } ``` ### Response36Afe1097B20_PriceInfo `#/components/schemas/Response36Afe1097B20_PriceInfo` ```json { "type": "object", "properties": { "current": { "type": [ "number", "null" ], "description": "現在の価格\n結果に掲載されている製品またはサービスの現在の価格を示します", "format": "double" }, "regular": { "type": [ "number", "null" ], "description": "通常価格\n割引が適用されていない製品またはサービスの通常価格を示します", "format": "double" }, "max_value": { "type": [ "number", "null" ], "description": "最高価格\n結果に示されている製品またはサービスの最高価格", "format": "double" }, "currency": { "type": [ "string", "null" ], "description": "表示価格の通貨\n価格に適用される通貨の ISO コード" }, "is_price_range": { "type": [ "boolean", "null" ], "description": "価格が範囲で提供されている\n価格が範囲で提供されているかどうかを示します" }, "displayed_price": { "type": [ "string", "null" ], "description": "結果の価格文字列\n結果で提供される生の価格文字列" } } } ``` ### Response36Afe1097B20_ProductInfoElement `#/components/schemas/Response36Afe1097B20_ProductInfoElement` ```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": "製品仕様ページでの要素の配置
次の値を取ることができます：
right、left" }, "product_id": { "type": [ "string", "null" ], "description": "POST 配列で受信した product_id
パラメーターの詳細については、このヘルプセンターガイドをご覧ください" }, "title": { "type": [ "string", "null" ], "description": "商品のタイトル" }, "description": { "type": [ "string", "null" ], "description": "製品の説明" }, "url": { "type": [ "string", "null" ], "description": "製品 URL
Google Shopping 上の製品の URL" }, "images": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "製品画像
製品画像への URL が含まれます" }, "features": { "type": [ "array", "null" ], "items": { "type": [ "string", "null" ] }, "description": "製品の機能
製品の機能の説明を含むスニペットが含まれます" }, "rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "製品の評価
レビューに基づく人気度" }, "seller_reviews_count": { "type": [ "integer", "null" ], "description": "販売者のレビュー数
製品販売者のアカウントのレビュー数", "format": "int64" }, "data_docid": { "type": [ "string", "null" ], "description": "SERP データ要素の一意の識別子
data_docid は Google によって割り当てられる動的値であるため、可能な値の完全な一覧は存在しないことに注意してください
例：
17363035694596624076" }, "gid": { "type": [ "string", "null" ], "description": "Google Shopping のグローバル製品識別子
gid は Google によって割り当てられる動的な値であるため、可能な値の完全なリストはありません
値がない場合は null が返されます
例：
4702526954592161872
gid の詳細については、このヘルプセンターガイドをご覧ください" }, "specifications": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ShoppingSpecification" } ] }, "description": "製品仕様
製品仕様ページに記載されているすべての製品属性と関連データが含まれます" }, "sellers": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductSeller" } ] }, "description": "製品の販売者
製品販売者のアカウントのレビュー数" }, "variations": { "type": [ "array", "null" ], "items": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_ProductVariation" } ] }, "description": "製品のバリエーション
さまざまな製品バリエーションに関する簡単な情報が含まれます" } } } ``` ### Response36Afe1097B20_ProductSeller `#/components/schemas/Response36Afe1097B20_ProductSeller` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "title": { "type": [ "string", "null" ], "description": "商品タイトル" }, "url": { "type": [ "string", "null" ], "description": "販売者の URL
製品が販売されているページの URL" }, "seller_rating": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_RatingElement" } ], "description": "販売者の評価" }, "seller_review_count": { "type": [ "integer", "null" ], "description": "販売者のレビュー数\n製品販売者のアカウントのレビュー数" }, "price": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_PriceInfo" } ], "description": "製品価格
販売者のウェブサイトでの製品価格の詳細" }, "delivery_info": { "type": [ "object", "null" ], "oneOf": [ { "$ref": "#/components/schemas/Response36Afe1097B20_DeliveryInfo" } ], "description": "配送情報
製品の配送情報" }, "product_availability": { "type": [ "string", "null" ], "description": "製品の在庫状況情報
次の値を取ることができます：in_stock、limited_stock、out_of_stock、backordered、pre_order_available、on_display_to_order" } } } ``` ### Response36Afe1097B20_ProductVariation `#/components/schemas/Response36Afe1097B20_ProductVariation` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "product_id": { "type": [ "string", "null" ], "description": "POST 配列内の商品 ID
このパラメーターの詳細についてはこちらのヘルプセンター ガイドをご覧ください" }, "gid": { "type": [ "string", "null" ], "description": "POST 配列内の GID ID
パラメーターの詳細については、このヘルプセンターガイドをご覧ください" }, "data_docid": { "type": [ "string", "null" ], "description": "POST 配列内の SERP データ要素の一意の識別子" }, "pvf": { "type": [ "string", "null" ], "description": "製品バリエーションのフィルター
製品バリエーション URL で特定の製品バリエーションの識別子として使用されます" }, "title": { "type": [ "string", "null" ], "description": "製品販売者の名前" }, "url": { "type": [ "string", "null" ], "description": "Google Shopping 上の製品バリエーション URL" }, "variation_category": { "type": [ "string", "null" ], "description": "製品バリエーションのカテゴリ
例：\"Storage Capacity\"" } } } ``` ### Response36Afe1097B20_RatingElement `#/components/schemas/Response36Afe1097B20_RatingElement` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "position": { "type": [ "string", "null" ], "description": "Google Shopping SERP における要素の配置
指定可能な値:
left、right" }, "rating_type": { "type": [ "string", "null" ], "description": "評価の種類
ここには次の要素があります：Max5、Percents、CustomMax" }, "value": { "type": [ "number", "null" ], "description": "評価の値" }, "votes_count": { "type": [ "integer", "null" ], "description": "フィードバックの量", "format": "int64" }, "rating_max": { "type": [ "integer", "null" ], "description": "rating_type の最大値" } } } ``` ### Response36Afe1097B20_ShoppingSpecification `#/components/schemas/Response36Afe1097B20_ShoppingSpecification` ```json { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "description": "要素の種類" }, "block_name": { "type": [ "string", "null" ], "description": "商品属性ブロックの名前
関連する要素が掲載されている商品仕様セクションの名前を示します" }, "specification_name": { "type": [ "string", "null" ], "description": "商品属性
商品データ仕様の属性名" }, "specification_value": { "type": [ "string", "null" ], "description": "仕様の内容" } } } ```