Produkt-IDs

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:

1. Kanal („online“ oder „lokal“)
2. Inhaltssprache (unter Verwendung der aus zwei Buchstaben bestehenden Kennzeichnung, z. B. en oder fr)
3. Feedlabel (kann der aus zwei Buchstaben bestehende Code für das Zielland des Feeds sein, z. B. US oder FR)
4. 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.