メインコンテンツへスキップ
Google Shopping(shopping.google.com)の商品を検索し、商品ページを非同期タスク API で読み取ります。COMMERCE_SERP に site google_shopping を指定すると検索結果の商品をストアの順に受け取り、COMMERCE_PRODUCT に商品の url を渡すとその商品を 1 つ読み取ります。完了した検索または商品ページ 1 件につき 2 クレジットです。

検索

タスクを送信したあと、GET /v1/async/task/{id} をポーリングするか Webhook で受け取ります。非同期タスクを参照してください。

パラメータ

  • site: 必須。google_shopping です。
  • query: 必須。検索語で、1-500 文字です。
  • limit: 任意の整数、1-40。デフォルトは 20 です。
  • country: 任意。デフォルトはストアの国の US です。ほかの国は 422 REGION_UNSUPPORTED で拒否されます。
受け付けるペイロードフィールドは上記のみです。include は省略してください。include: {} でも、クレジットを確保する前に payload.include の 422 VALIDATION_ERROR を返します。

レスポンス例

結果フィールド

  • site、query、country はリクエストの値です。returnedCount は products の件数です。
  • 各商品は rank、productId、title、url を含みます。productId は Google の商品 ID で、Google が商品にまとめていない出品はオファー ID です。rank はストアのデフォルトの並び順で、ストアが広告と表示した商品は除きます。
  • price、rating、reviewCount、imageUrl、seller は、検索結果の画面に表示されている場合に含みます。price は商品ごとの currency(ISO 4217)の数値で、容量ごとに価格が異なる場合は最も低い価格です。
  • rating は 5 点満点です。 999+ のように省略表示されたレビュー数は含みません。 reviewCount は、Google が正確な件数(1,000 件未満)を表示する場合だけ含みます。
  • 検索ごとに、ストアの検索結果の 1 ページ目から商品を取得します。
  • Google のページには商品や販売店のページへのリンクがないため、url は商品が表示された Google Shopping の検索結果ページの末尾に #product={productId}&title={title} を付けたアドレスです。この url を COMMERCE_PRODUCT に渡すと、商品の販売店、仕様、説明を読み取ります。seller は Google が最初に表示する販売店です。

商品ページ

パラメータ

  • url: 必須。Google Shopping の検索が返した商品の url で、2,048 文字以内です。形式は google.com/search?q={query}&udm=28&gl={market}#product={productId}&title={title} です。Google 検索、Google AIによる概要、Google AIモード の結果にある商品の productDetailUrl もそのまま使えます。
  • country: 任意。デフォルトは url の gl で、US、GB、AU、CA、KR、JP、TW、HK、DE、FR、ES、IT、PL、PT、BR、IN、ID、TH、VN のいずれかです。ほかの国は 422 REGION_UNSUPPORTED で拒否されます。
受け付けるペイロードフィールドは上記のみです。include は省略してください。include: {} でも、クレジットを確保する前に payload.include の 422 VALIDATION_ERROR を返します。

レスポンス例

結果フィールド

  • site、country、url、productId でページを識別します。url は読み取ったページで、productId は検索結果の ID と同じです。
  • title は常に含みます。brand、price、listPrice、currency、inStock、seller、rating、reviewCount、images、description、specs、offers は、ページに表示されている場合に含みます。
  • price は、クーポンと送料を適用する前にページが最初に表示する購入価格で、currency(ISO 4217)の値です。 listPrice はページが取り消し線で表示する通常価格で、price より高い場合だけ含みます。 inStock は在庫の有無です。 seller は販売者です。
  • rating は小数第 2 位までの 5 点満点の評価です。 reviewCount はレビュー数です。 reviewCount は、Google が正確な件数(1,000 件未満)を表示する場合だけ含みます。
  • images は商品ギャラリーの写真を、ページの順に最大 30 枚含みます。
  • description は段落ごとに 1 行のプレーンテキストで、最大 10,000 文字です。画像の中にしかない文字は含みません。
  • specs は商品詳細の { name, value } の組を最大 100 個含みます。
  • 読み取りでは url の検索語をその市場の Google Shopping で再び検索し、Google がその検索語で商品を表示しなくなった場合は商品名で検索して、商品パネルを開きます。そのためストアのページより時間がかかります。どちらの検索にも商品がない場合、タスクは PAGE_UNAVAILABLE で終了します。
  • offers は Google が表示する販売店を、Google が最安値と示す販売店から順に含みます。各販売店には seller、title(販売店の商品名)、url(Google がリンクする場合は販売店の商品ページ)、price、listPrice、currency、inStock があります。商品の price、listPrice、seller、inStock は最初の販売店のものです。価格は表示言語に関係なく、その市場の Shopping タブの通貨(ISO 4217)です。
  • Google AIによる概要や AIモードの商品の productDetailUrl は商品名で検索し、結果にその商品の productDocid を含みます。

エラーと課金

  • 商品が 1 つもない検索は、失敗したタスクとして終了します。
  • 課金は完了したタスクだけで、検索または商品ページ 1 件につき 2 クレジットです。

関連