プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Googleショッピングの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordでGoogle Shoppingを検索し、価格と取り消し線付きの価格、販売者、評価、レビュー数、画像、Googleの商品IDを含む商品を最大100件取得します。countryでマーケットを指定し、価格帯で絞り込み、価格または評価で並べ替えられます。 | 1,000リクエストあたり$0.56 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Googleショッピングの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | country, language, max_price, min_price, sort | Sync配信 | カタログ値：defaultLimit=20、maxLimit=100。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | rank · title · product_id · offer_id · image_id · price_text · price · old_price_text · old_price · merchant · multiple_merchants · rating · rating_scale · review_count · image_url · url · platform |
Googleショッピングのsearchのパラメータはそれぞれどういう意味ですか？
keywordでGoogle Shoppingを検索し、価格と取り消し線付きの価格、販売者、評価、レビュー数、画像、Googleの商品IDを含む商品を最大100件取得します。countryでマーケットを指定し、価格帯で絞り込み、価格または評価で並べ替えられます。
keyword必須- 商品の検索キーワードです（例：
wireless earbuds）。 country任意- 検索対象のGoogle Shoppingマーケットを表す2文字の国コードです（例：
us、gb、de。デフォルトはus）。価格はそのマーケットの通貨で表示されます。 language任意- タイトルやラベルの言語を表す2文字の言語コードです（例：
en、de。デフォルトはen）。 max_price任意- 含める最高価格です。
min_price未満の値は指定できません。 min_price任意- 含める最低価格です。
countryのマーケットの通貨で、0以上の値を指定します。Google Merchant Center：商品データ仕様における価格とセール価格 — Google Merchant Centerの商品データ仕様によると、販売者はタイトル、価格、任意のsale_priceなどの属性を含めて商品を登録し、Googleはこのデータを使って商品を検索内容と照合します。この資料で確認できるのは、Googleショッピングの価格が販売者の商品データに基づき、通常価格とセール価格が区別されていることのみです。このAPIの`min_price`と`max_price`は検索対象国の通貨で結果を絞り込むもので、EveryInfraが定義しています。この資料はこのフィルターや結果の件数を保証するものではありません。 · 確認日 sort任意- 並び順です。
price_low（価格の安い順）、price_high（価格の高い順）、rating（評価の高い順）のいずれかを指定します。省略すると関連度順になります。
Googleショッピング APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"google_shopping","action":"search","params":{"keyword":"<keyword>"}}'
Googleショッピング APIに関する質問
Googleショッピング APIでは何を取得できますか？
platformをgoogle_shoppingに設定します。現在のカタログには検索が掲載されています。これらのアクション名はそれぞれ異なるGoogleショッピングのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Googleショッピングのsearchリクエストを開始するには、どの入力を使用しますか？
商品の検索キーワードです（例：wireless earbuds）。params内のkeywordとして送信してください。
Googleショッピングのsearchはどのフィールドを返しますか？
宣言されたスキーマにはrank、title、product_id、offer_idが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Googleショッピングのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。