rocket
Content API for Shopping'in resmi olarak yerini alacak olan
Merchant API ile tanışın.
add_alert
Not: Content API for Shopping, 18 Ağustos 2026'da kullanımdan kaldırılacak.
Ürün Kimlikleri
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Content API for Shopping'deki farklı ürün kimliği türleri aşağıda belirtilmiştir:
- Teklif kimliği
offerId, satıcı tarafından bir ürüne atanan dizedir. Bu kimlik, bağımsız bir ürünü temsil eder.offerId, Merchant Center veritabanındaki teklif grubu için benzersizdir ve genellikle sayısal bir sıralı sayıdır.offerId, satıcının ürüne atadığı dahili bir SKU numarası olabilir.- REST KİMLİĞİ
- REST kimliği, Google tarafından atanan bir ürünün benzersiz tanımlayıcısıdır.
- REST kimliği, REST API çağrıları için
productId olarak kullanılır.
REST kimlikleri, online:en:label:1111111111 biçiminde birleştirilir. REST kimliği, iki nokta üst üste ile ayrılmış aşağıdaki 4 bölümden oluşur:
- Kanal ("online" veya "yerel")
- İçerik Dili (2 harfli tanım kullanılarak; örneğin,
en veya fr)
- Feed etiketi (feed'in hedef ülkesinin iki harfli kodu olabilir; örneğin,
US veya FR)
- Teklif kimliği
Bunu channel:contentLanguage:feedLabel:offerId olarak, örneğin, online:en:US:1111111111 olarak oluşturursunuz.
- Harici Satıcı Kimliği (Ticaret Siteleri)
Ticaret siteleri, çok satıcılı hesaba yüklenen tekliflere external_seller_id atamalıdır. Bu alan bireysel bir satıcıyı temsil eder.
external_seller_id değerleri büyük/küçük harfe duyarlıdır ve aşağıdaki ölçütleri karşılamalıdır:
- 1-50 karakter uzunluğunda
- Yalnızca alfanümerik ASCII karakterler ve alt çizgi (_), kısa çizgi (-), nokta (.) ve yaklaşık işareti (~)
Bu, dahili seller_id alanıyla aynı değildir.
Aşağıdaki tabloda, bir ürünle ilişkilendirilebilecek kimliklerden bazıları özetlenmektedir:
| Özellik |
Açıklama |
Örnek |
Notlar |
offerId |
Bir satıcıya satıcı tarafından atanan kimlik. |
1111111111 |
Dize veri türü, ürün teklifi için benzersiz tanımlayıcı. |
| REST KİMLİĞİ |
Bir ürüne Google tarafından atanan kimlik. channel:contentLanguage:feedLabel:offerId biçiminde. |
online:en:label:1111111111 |
offerId dahil tam kimlik. |
productId |
API çağrılarında REST kimliğine başvuruda bulunmak için kullanılır. |
online:en:label:1111111111 |
Bu, ürünün REST kimliğidir. |
id |
REST kimliği ve productId ile aynı değer. |
online:en:label:1111111111 |
Bir ürünün productId bilgisini belirtmek için JSON gövdesinde kullanılır. |
external_seller_id |
Pazar Yeri tarafından seçilen satıcı kimliği. |
example-Seller1 |
Çok satıcılı hesaplar için gereklidir. 1 ila 50 karakter uzunluğunda olmalıdır. Büyük/küçük harfe duyarlıdır. Rakamlar ve özel karakterler _, -, . ve ~
kabul edilir.
|
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-13 UTC.
[null,null,["Son güncelleme tarihi: 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. |"]]
