Identyfikatory produktów

Oto różne rodzaje identyfikatorów produktów w Content API for Shopping:

Identyfikator oferty
offerId to ciąg znaków przypisany do produktu przez sprzedawcę. Wskazuje on konkretny produkt.
Atrybut offerId jest unikalny dla zestawu ofert w bazie danych Merchant Center i jest zwykle numeracją sekwencyjną.
offerId może być wewnętrznym numerem SKU przypisanym przez sprzedawcę do produktu.
Identyfikator REST
Identyfikator REST to unikalny identyfikator produktu przypisany przez Google.
Identyfikator REST to identyfikator productId używany w wywołaniach interfejsu API REST.

Identyfikatory REST są agregowane w formacie online:en:label:1111111111. Identyfikator REST składa się z 4 części rozdzielonych dwukropkiem:

  1. Kanał („online” lub „local”)
  2. Język treści (używając dwuliterowego oznaczenia, np. en lub fr);
  3. Etykieta pliku danych (może to być dwuliterowy kod kraju docelowego, np. US lub FR)
  4. Identyfikator oferty

Twój wynik to channel:contentLanguage:feedLabel:offerId, na przykład online:en:US:1111111111.

Zewnętrzny identyfikator sprzedawcy (platformy handlowe)

Platformy handlowe muszą przypisywać external_seller_id do ofert przesłanych na konto wielu sprzedawców. To pole dotyczy pojedynczego sprzedawcy.

W wartościach external_seller_id rozróżniana jest wielkość liter. Muszą one spełniać te kryteria:

  • Długość: 1–50 znaków
  • Tylko znaki alfanumeryczne ASCII, podkreślenia (_), łącznik (-), kropka (.) i tylda (~)

Nie jest to to samo co wewnętrzne pole seller_id.

W tej tabeli znajdziesz podsumowanie niektórych identyfikatorów, które można powiązać z usługą:

Atrybut Opis Przykład Notatki
offerId Identyfikator przypisany do produktu przez sprzedawcę. 1111111111 Typ danych ciągu znaków: unikalny identyfikator oferty produktu.
Identyfikator REST Identyfikator przypisany do produktu przez Google. W formacie channel:contentLanguage:feedLabel:offerId. online:en:label:1111111111 Pełny identyfikator, w tym offerId.
productId Służy do odwoływania się do identyfikatora REST w wywołaniach interfejsu API. online:en:label:1111111111 Jest to identyfikator REST produktu.
id Ta sama wartość co identyfikator REST i productId. online:en:label:1111111111 Używana w treści JSON produktu w celu odwołania się do jego productId.
external_seller_id Identyfikator sprzedawcy wybrany przez platformę handlową. example-Seller1 Wymagane w przypadku kont wielu sprzedawców. Musi mieć od 1 do 50 znaków. Wielkość liter jest rozróżniana. Dozwolone są cyfry i znaki specjalne _, -, . i ~.