Produkt-IDs

Deshalb möchten wir die Betaversion der Merchant API einführen. Content API for Shopping ist die neue und künftige Version der Content API for Shopping.

Informationen dazu, wie Sie mit der Merchant API die Einbindung verbessern und die Zukunft mitgestalten können, finden Sie unter Ankündigung der Betaversion der Merchant API.

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:

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