rocket
Content API for Shopping の正式な後継である
Merchant API をご紹介します。
update
Merchant API の新機能、バグの修正、更新に関する
最新情報を入手してください。
add_alert
注: Content API for Shopping は 2026 年 8 月 18 日に廃止されます。
無料リスティングに購入手続きリンクを追加する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
無料リスティングの checkoutSettings 属性を使用すると、ユーザーが購入手続きページに直接移動できるリンクを指定できます。詳しくは、無料リスティングに購入手続きリンクを追加するをご覧ください。
購入手続きプログラムに参加するには、お客様のビジネスと商品に関する具体的な情報を提供していただく必要があります。checkoutSettings を使用するには、次の条件を満たす必要があります。
Google Merchant Center の UI で、無料リスティング プログラムにすでに登録されているかどうかを確認します。登録していない場合は、無料リスティングのオンボーディングの手順を完了します。購入手続きの URL には次の形式を使用します。
https://mystore.com/path-to-product/{id}
無料リスティングの購入手続き URL をユーザーがクリックすると、{id} は商品の offerId に自動的に置き換えられます。
購入手続きの URL を追加する
freelistingsprogram.checkoutsettings.insert を使用して、購入手続きの URL テンプレートを追加または更新できます。この呼び出しは、アカウント単位で購入手続き URL テンプレートを更新し、すべての有効な商品を購入手続き機能に登録します。
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings
次の例をご覧ください。
{
uri_settings: {
checkout_uri_template: "https://domain_name.com/custom_path/{id}"
}
}
現在の購入手続き URL を確認する
freelistingsprogram.checkoutsettings.get を使用すると、既存の購入手続き URL を確認できます。get は読み取り専用で、merchantId が必要です。get メソッドは、対応する checkout リソースを返します。
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings
購入手続き URL を削除する
購入手続きの URL は、freelistingsprogram.checkoutsettings.delete を使用して削除できます。これにより、すべての商品で購入手続き機能が無効になります。
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-13 UTC。
[null,null,["最終更新日 2025-08-13 UTC。"],[[["\u003cp\u003eGoogle is introducing the Merchant API beta, the new version of the Content API for Shopping.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003echeckoutSettings\u003c/code\u003e attribute to add a checkout link directly to your free listings, enhancing the customer shopping experience.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize \u003ccode\u003echeckoutSettings\u003c/code\u003e, you need an active product feed in Google Merchant Center and be enrolled in the free listings program.\u003c/p\u003e\n"],["\u003cp\u003eImplement the checkout feature by adding or updating your checkout URL template using the provided API calls, allowing customers to purchase directly from your free listings.\u003c/p\u003e\n"],["\u003cp\u003eManage your checkout URL by viewing, updating, or removing it via the respective API calls, giving you control over the checkout process for your free listings.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. To use `checkoutSettings` for free listings, users need an active product feed and enrollment in the free listings program. Merchants can add or update their checkout URL templates using `freelistingsprogram.checkoutsettings.insert`, view existing URLs with `get`, and remove them with `delete`. The checkout URL directs customers to a product's checkout page, automatically replacing `{id}` with the product's `offerId`.\n"],null,["# Add a checkout link to your free listings\n\nYou can use the\n[`checkoutSettings`](/shopping-content/reference/rest/v2.1/CheckoutSettings)\nattribute of free listings to provide a link for customers to go directly to the\ncheckout page. For more information, see [add a checkout link for your free\nlistings](//support.google.com/merchants/answer/13580732).\n\nYou must provide specific information about your business and products before\nyou can opt in to the checkout program. You must meet the following criteria to\nuse `checkoutSettings`:\n\n- Have an active [product\n feed](//support.google.com/merchants/answer/7439882?) in the [Google\n Merchant Center](//merchants.google.com/).\n- Your merchant account must be enrolled in the free listings program.\n\nCheck the Google Merchant Center UI to see if you're already enrolled in the\nfree listings program. If you're not enrolled, complete the [free listings\nonboarding](//support.google.com/merchants/answer/9455788) steps. Use the\nfollowing format for your checkout URLs: \n\n https://mystore.com/path-to-product/{id}\n\nWhen a customer clicks on the checkout URL in your free listing, `{id}` is\nautomatically replaced with the [`offerId`](/shopping-content/guides/products/product-id) of the product.\n\nAdd your checkout URL\n---------------------\n\nYou can use\n[`freelistingsprogram.checkoutsettings.insert`](/shopping-content/reference/rest/v2.1/freelistingsprogram.checkoutsettings/insert)to\nadd or update your checkout URL template. This call updates your checkout URL\ntemplate at the account level, and opts all valid offers into the checkout\nfeature. \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings\n\nHere's an example: \n\n {\n uri_settings: {\n checkout_uri_template: \"https://domain_name.com/custom_path/{id}\"\n }\n }\n\nView your current checkout URL\n------------------------------\n\nYou can use\n[`freelistingsprogram.checkoutsettings.get`](/shopping-content/reference/rest/v2.1/freelistingsprogram.checkoutsettings/get)\nto view your existing checkout URL. `get` is read-only, and requires your\n`merchantId`. The `get` method returns the corresponding `checkout` resource. \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings\n\nRemove your checkout URL\n------------------------\n\nYou can remove your checkout URL by using\n[`freelistingsprogram.checkoutsettings.delete`](/shopping-content/reference/rest/v2.1/freelistingsprogram.checkoutsettings/delete).\nThis opts all your offers out of the checkout feature. \n\n DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings"]]
