rocket
Merchant API
– der offizielle Nachfolger der Content API for Shopping.
add_alert
Hinweis: Die Content API for Shopping wird am 18. August 2026 eingestellt.
Produkt-IDs
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Im Folgenden sind die verschiedenen Arten von Produkt-IDs in der Content API for Shopping aufgeführt:
- Angebots-ID
- Ein
offerId ist ein String, der einem Produkt von einem Händler zugewiesen wird. Diese ID stellt ein einzelnes Produkt dar.
offerId ist einzigartig für die Gruppe von Angeboten in der Merchant Center-Datenbank und normalerweise eine numerische fortlaufende Nummer.offerId kann eine interne Artikelnummer sein, die ein Händler dem Produkt zuweist.- REST-ID
- Eine REST-ID ist die eindeutige Kennung für ein von Google zugewiesenes Produkt.
- Die REST-ID ist die
productId für REST API-Aufrufe.
REST-IDs sind Aggregationen im Format online:en:label:1111111111. Die REST-ID besteht aus den folgenden vier Teilen, getrennt durch Doppelpunkte:
- Kanal („online“ oder „lokal“)
- Inhaltssprache (unter Verwendung der aus zwei Buchstaben bestehenden Kennzeichnung, z. B.
en oder fr)
- Feedlabel (kann der aus zwei Buchstaben bestehende Code für das Zielland des Feeds sein, z. B.
US oder FR)
- Angebots-ID
Sie setzen dies als channel:contentLanguage:feedLabel:offerId zusammen, z. B. online:en:US:1111111111.
- Externe Verkäufer-ID (Marktplätze)
Marktplätze müssen Angeboten, die in ein Mehrfachkundenkonto hochgeladen wurden, einen external_seller_id zuweisen. Dieses Feld stellt einen einzelnen Verkäufer dar.
Bei external_seller_id-Werten wird zwischen Groß- und Kleinschreibung unterschieden und sie müssen die folgenden Kriterien erfüllen:
- 1–50 Zeichen
- Nur alphanumerische ASCII-Zeichen und Unterstriche (_), Bindestriche (-), Punkte (.) und Tilden (~)
Dies ist nicht mit dem internen Feld seller_id identisch.
In der folgenden Tabelle sind einige der IDs zusammengefasst, die einem Produkt zugeordnet werden können:
| Attribut |
Beschreibung |
Beispiel |
Hinweise |
offerId |
Eine ID, die einem Produkt von einem Händler zugewiesen wird. |
1111111111 |
String-Datentyp, eindeutige Kennung für ein Produktangebot. |
| REST-ID |
Eine ID, die einem Produkt von Google zugewiesen wurde. Im Format channel:contentLanguage:feedLabel:offerId. |
online:en:label:1111111111 |
Vollständige ID einschließlich offerId. |
productId |
Wird in API-Aufrufen zum Verweis auf die REST-ID verwendet. |
online:en:label:1111111111 |
Dies ist die REST-ID eines Produkts. |
id |
Hat denselben Wert wie eine REST-ID und productId. |
online:en:label:1111111111 |
Wird im JSON-Text eines Produkts verwendet, um auf das productId zu verweisen. |
external_seller_id |
Eine vom Marktplatz ausgewählte Verkäufer-ID. |
example-Seller1 |
Erforderlich für Mehrfachkundenkonten. Muss 1–50 Zeichen lang sein. Dabei wird die Groß-/Kleinschreibung berücksichtigt. Ziffern und Sonderzeichen _, -, . und ~ sind zulässig.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-13 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]
