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:- Kanał („online” lub „local”)
- Język treści (z dwuliterowym oznaczeniem, np.
en
lubfr
) - Etykieta pliku danych (może to być dwuliterowy kod kraju docelowego pliku danych, np.
US
lubFR
). - Identyfikator oferty
Składasz je jako
channel:contentLanguage:feedLabel:offerId
, na przykładonline: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 ~. |