Dies sind die verschiedenen Arten von Produkt-IDs in der Content API for Shopping:
- Angebots-ID
- Ein
offerId
ist ein String, der einem Produkt von einem Händler zugewiesen wird. Diese ID repräsentiert ein einzelnes Produkt. offerId
ist für eine Gruppe von Angeboten in der Merchant Center-Datenbank eindeutig und in der Regel 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 Produkt, die von Google zugewiesen wird.
- Die REST-ID ist der
productId
für REST API-Aufrufe. REST-IDs sind aggregierte Daten im Format
online:en:label:1111111111
. Die REST-ID besteht aus den folgenden vier durch Doppelpunkten getrennten Teilen:- Kanal ("online" oder "lokal")
- Inhaltssprache (mit der aus zwei Buchstaben bestehenden Bezeichnung, z. B.
en
oderfr
) - Feedlabel (z. B. der aus zwei Buchstaben bestehende Code für das Zielland des Feeds, z. B.
US
oderFR
) - Angebots-ID
Sie haben dies als
channel:contentLanguage:feedLabel:offerId
zusammengefasst, z. B.online:en:US:1111111111
.- Externe Verkäufer-ID (Marktplätze)
Marktplätze müssen Angeboten, die in ein Mehrfachkundenkonto hochgeladen werden, eine
external_seller_id
zuweisen. Dieses Feld steht für einen einzelnen Verkäufer.Bei
external_seller_id
-Werten wird zwischen Groß- und Kleinschreibung unterschieden. Außerdem müssen sie die folgenden Kriterien erfüllen:- Länge: 1–50 Zeichen
- Nur alphanumerische ASCII-Zeichen sowie Unterstriche (_), Bindestrich (-), Punkt (.) und Tilde (~)
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 das Angebot eines Produkts. |
REST-ID | Eine ID, die einem Produkt von Google zugewiesen wird. Im Format channel:contentLanguage:feedLabel:offerId . |
online:en:label:1111111111 |
Vollständige ID, einschließlich offerId . |
productId |
Wird in API-Aufrufen verwendet, um auf die REST-ID zu verweisen. | online:en:label:1111111111 |
Dies ist die REST-ID eines Produkts. |
id |
Identischer Wert wie REST-ID und productId . |
online:en:label:1111111111 |
Wird im JSON-Text eines Produkts verwendet, um auf sein productId zu verweisen. |
external_seller_id |
Eine vom Marktplatz ausgewählte Verkäufer-ID. | example-Seller1 |
Erforderlich für Mehrfachkundenkonten. Muss zwischen 1 und 50 Zeichen lang sein. Dabei wird die Groß-/Kleinschreibung berücksichtigt. Ziffern und Sonderzeichen _, -, . und ~ sind zulässig. |