rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
עדכונים אחרונים
לגבי תכונות חדשות, תיקוני באגים וגרסאות חדשות של Merchant API
add_alert
הערה: אנחנו נוציא משימוש את Content API for Shopping ב-18 באוגוסט 2026.
מזהי המוצרים
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
אלה הסוגים השונים של מזהי המוצרים ב-Content API for Shopping:
- מזהה מבצע
offerId הוא מחרוזת שהוקצתה למוצר על ידי מוכר. המזהה הזה מייצג מוצר ספציפי.offerId הוא ייחודי לקבוצת המוצרים במסד הנתונים של Merchant Center, ובדרך כלל הוא מספר סידורי.offerId יכול להיות מספר מק"ט פנימי שמוכר מקצה למוצר.- מזהה REST
- מזהה REST הוא המזהה הייחודי של מוצר שהוקצה על ידי Google.
- מזהה REST הוא
productId לקריאות ל-API ל-REST.
מזהי REST נצברים בפורמט online:en:label:1111111111. מזהה ה-REST מורכב מ-4 החלקים הבאים, מופרדים בנקודתיים:
- ערוץ ("אונליין" או "מקומי")
- שפת תוכן (באמצעות הקצאה של שתי אותיות, לדוגמה
en או fr)
- תווית פיד (יכול להיות קוד של שתי אותיות למדינת היעד של הפיד, לדוגמה:
US או FR)
- מזהה מבצע
הנתונים האלה מקובצים בתור channel:contentLanguage:feedLabel:offerId, לדוגמה, online:en:US:1111111111.
- מזהה חיצוני של אתר מכירה (Marketplaces)
בזירות מסחר צריך להקצות external_seller_id למוצרים שהועלו לחשבון של בתי עסק מרובים. השדה הזה מייצג מוכר עצמאי.
הערכים ב-external_seller_id הם תלויי אותיות רישיות וצריכים לעמוד בקריטריונים הבאים:
- אורך של 1-50 תווים
- רק תווי ASCII אלפאנומריים וקווים תחתונים (_), מקף (-), נקודות (.) וטילדה (~)
השדה הזה לא זהה לשדה seller_id הפנימי.
בטבלה הבאה מופיע סיכום של כמה מהמזהים שאפשר לשייך למוצר:
| מאפיין |
תיאור |
דוגמה |
הערות |
offerId |
מזהה שמוקצה למוצר על ידי המוכר. |
1111111111 |
סוג נתוני מחרוזת, מזהה ייחודי להצעה של מוצר. |
| מזהה REST |
מזהה ש-Google מקצה למוצר. בפורמט channel:contentLanguage:feedLabel:offerId. |
online:en:label:1111111111 |
מזהה מלא כולל offerId. |
productId |
משמש לציון מזהה ה-REST בקריאות ל-API. |
online:en:label:1111111111 |
זהו מזהה REST של מוצר. |
id |
אותו הערך כמו מזהה REST ו-productId. |
online:en:label:1111111111 |
משמש בתוך גוף ה-JSON של מוצר ל-productId. |
external_seller_id |
מזהה של אתר מכירה שנבחר על ידי Marketplace. |
example-Seller1 |
נדרש בחשבונות מרובי אתרי מכירה. הסיסמה חייבת לכלול בין 1 ל-50 תווים. תלוי רישיות. ניתן להשתמש בספרות ובתווים מיוחדים _, -, . ו-~.
|
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-13 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-13 (שעון UTC)."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration with Google.\u003c/p\u003e\n"],["\u003cp\u003eThe beta version of the Merchant API is now available for developers to explore and help shape its future development.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can learn more about the benefits and features of the Merchant API, including how it can enhance integrations, in the official announcement blog post.\u003c/p\u003e\n"],["\u003cp\u003eProducts in the Merchant API are identified using various IDs, such as \u003ccode\u003eofferId\u003c/code\u003e, REST ID, \u003ccode\u003eproductId\u003c/code\u003e, and \u003ccode\u003eexternal_seller_id\u003c/code\u003e, each with specific characteristics and usage contexts.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table provides detailed explanations and examples of different product ID attributes, outlining their purpose and format.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. Merchants assign an `offerId` to products. Google assigns a unique REST ID in the format `channel:contentLanguage:feedLabel:offerId`; this is also the `productId` and `id` in API calls. Marketplaces assign `external_seller_id` to offers for multi-seller accounts, it has specific format requirements. The Merchant API offers integration improvements; details on this and providing feedback are available via a linked article.\n"],null,["# Product IDs\n\nHere are the different kinds of product IDs in the Content API for Shopping:\n\nOffer ID\n: An `offerId` is a string assigned to a product by a merchant. This ID\n represents an individual product.\n: `offerId` is unique to the set of offers in the Merchant Center database, and\n is usually a numeric sequential number.\n: `offerId` can be an internal SKU number that a merchant assigns to the product.\n\nREST ID\n: A REST ID is the unique identifier for a product assigned by Google.\n: REST ID is the `productId` for REST API calls.\n\n: REST IDs are aggregates with the format `online:en:label:1111111111`. The\n REST ID consists of the following 4 parts, separated by colons:\n\n 1. Channel (\"online\" or \"local\")\n 2. Content Language (using the 2-letter designation, for example `en` or `fr`)\n 3. Feed label (might be the two-letter code for the feed's target country, for example `US` or `FR`)\n 4. Offer ID\n\n: You put this together as `channel:contentLanguage:feedLabel:offerId`, for\n example, `online:en:US:1111111111`.\n\nExternal Seller ID (Marketplaces)\n\n: [Marketplaces](//support.google.com/merchants/answer/6363319)\n must assign an `external_seller_id` to offers uploaded to a multi-seller\n account. This field represents an individual seller.\n\n `external_seller_id` values are case-sensitive, and must meet the following\n criteria:\n\n - 1-50 characters in length\n - Only alphanumeric ASCII characters, and underscore (_), hyphen (-), period (.), and tilde (\\~)\n\n This isn't the same as the internal\n [`seller_id`](/shopping-content/reference/rest/v2.1/accounts) field.\n\nThe following table summarizes some of the IDs that can be associated with a\nproduct:\n\n| Attribute | Description | Example | Notes |\n|----------------------|---------------------------------------------------------------------------------------------------|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `offerId` | An ID assigned to a product by a merchant. | `1111111111` | String data type, unique identifier for a product's offer. |\n| REST ID | An ID assigned to a product by Google. In the format `channel:contentLanguage:feedLabel:offerId`. | `online:en:label:1111111111` | Full ID including `offerId`. |\n| `productId` | Used to refer to the REST ID in API calls. | `online:en:label:1111111111` | This is the REST ID of a product. |\n| `id` | Same value as REST ID and `productId`. | `online:en:label:1111111111` | Used inside JSON body of a product to refer to its `productId`. |\n| `external_seller_id` | A seller ID chosen by the Marketplace. | `example-Seller1` | Required for multi-seller accounts. Must be 1-50 characters. Case-sensitive. Digits, and special characters _, -, ., and \\~ are accepted. |"]]
