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ę. Reprezentuje on pojedynczy produkt.
offerId to zbiór ofert w bazie danych Merchant Center, który zwykle jest liczbą numeryczną.
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 productId dla wywołań interfejsu API REST.

Identyfikatory REST to dane zbiorcze w formacie online:en:label:1111111111. Identyfikator REST składa się z 4 części rozdzielonych dwukropkami:

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

Składasz je jako channel:contentLanguage:feedLabel:offerId, na przykład online:en:US:1111111111.

Zewnętrzny identyfikator sprzedawcy (platformy handlowe)

Platformy handlowe muszą przypisać właściwość external_seller_id do ofert przesłanych na konto wielu sprzedawców. To pole reprezentuje sprzedawcę indywidualnego.

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

  • 1–50 znaków
  • Tylko znaki alfanumeryczne ASCII oraz podkreślenia (_), łączniki (-), kropki (.) i tyldy (~)

To nie to samo co wewnętrzne pole seller_id.

Poniższa tabela zawiera podsumowanie niektórych identyfikatorów, które można powiązać z produktem:

Atrybut opis, Przykład Uwagi
offerId Identyfikator przypisany do produktu przez sprzedawcę. 1111111111 Typ danych ciągu: unikalny identyfikator oferty produktu.
Identyfikator REST Identyfikator przypisany do produktu przez Google. Format 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 Wartość jest taka sama jak w przypadku identyfikatora REST i productId. online:en:label:1111111111 Używana w treści JSON w odniesieniu do produktu productId.
external_seller_id Identyfikator sprzedawcy wybrany przez Marketplace. example-Seller1 Wymagany 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 _, -, . oraz ~.