Produkt-IDs

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.