rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگی‌های Merchant API، رفع اشکال‌ها و به‌روزرسانی‌ها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب می‌کند.
پیوند پرداخت را به لیست های رایگان خود اضافه کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
می‌توانید از ویژگی checkoutSettings لیست‌های رایگان برای ارائه پیوندی برای مشتریان برای رفتن مستقیم به صفحه پرداخت استفاده کنید. برای اطلاعات بیشتر، به افزودن پیوند تسویه حساب برای لیست های رایگان خود مراجعه کنید.
قبل از اینکه بتوانید در برنامه تسویه حساب شرکت کنید، باید اطلاعات خاصی درباره کسب و کار و محصولات خود ارائه دهید. برای استفاده از checkoutSettings باید معیارهای زیر را داشته باشید:
رابط کاربری Google Merchant Center را بررسی کنید تا ببینید آیا قبلاً در برنامه لیست های رایگان ثبت نام کرده اید یا خیر. اگر ثبت‌نام نکرده‌اید، مراحل ورود به فهرست‌های رایگان را تکمیل کنید. از قالب زیر برای URL های پرداخت خود استفاده کنید:
https://mystore.com/path-to-product/{id}
وقتی مشتری روی نشانی اینترنتی تسویه حساب در فهرست رایگان شما کلیک می کند، {id} به طور خودکار با offerId محصول جایگزین می شود.
URL تسویه حساب خود را اضافه کنید
می‌توانید از freelistingsprogram.checkoutsettings.insert برای افزودن یا به‌روزرسانی الگوی 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 تسویه حساب خود را حذف کنید
با استفاده از freelistingsprogram.checkoutsettings.delete می‌توانید URL پرداخت خود را حذف کنید. با این کار همه پیشنهادات شما از ویژگی تسویه حساب حذف می شود.
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی."],[[["\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"]]
