rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
עדכונים אחרונים
לגבי תכונות חדשות, תיקוני באגים וגרסאות חדשות של Merchant API
add_alert
הערה: אנחנו נוציא משימוש את Content API for Shopping ב-18 באוגוסט 2026.
הוספת קישור לדף התשלום בכרטיסי המוצר החינמיים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אתם יכולים להשתמש במאפיין checkoutSettings של כרטיסי מוצר חינמיים כדי לספק ללקוחות קישור שיעביר אותם ישירות לדף התשלום. מידע נוסף זמין במאמר בנושא הוספת קישור לדף תשלום בכרטיסי מוצר חינמיים.
כדי להצטרף לתוכנית של דפי התשלום, אתם צריכים לספק מידע ספציפי על העסק ועל המוצרים שלכם. כדי להשתמש ב-checkoutSettings, אתם צריכים לעמוד בקריטריונים הבאים:
בודקים בממשק המשתמש של Google Merchant Center אם כבר נרשמתם לתוכנית כרטיסי המוצר החינמיים. אם לא נרשמתם לתוכנית, צריך להשלים את השלבים של הפעלת כרטיסי מוצר חינמיים. צריך להשתמש בפורמט הבא לכתובות ה-URL של תהליך התשלום:
https://mystore.com/path-to-product/{id}
כשלקוח לוחץ על כתובת ה-URL של דף התשלום בכרטיס החינמי, המערכת מחליפה באופן אוטומטי את {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 של הדף לתשלום
כדי להסיר את כתובת ה-URL של תהליך התשלום, אפשר להשתמש בfreelistingsprogram.checkoutsettings.delete.
הפעולה הזו תבטל את ההסכמה שלכם להפעלת התכונה 'תשלום בקופה' בכל המוצרים.
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/freelistingsprogram/checkoutsettings
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 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"]]
