Oto różne rodzaje identyfikatorów produktów w Content API for Shopping:
- Identyfikator oferty
offerIdto ciąg znaków przypisany do produktu przez sprzedawcę. Reprezentuje on pojedynczy produkt.offerIdto zbiór ofert w bazie danych Merchant Center, który zwykle jest liczbą numeryczną.offerIdmoż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
productIddla 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.
enlubfr) - Etykieta pliku danych (może to być dwuliterowy kod kraju docelowego pliku danych, np.
USlubFR). - 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_iddo ofert przesłanych na konto wielu sprzedawców. To pole reprezentuje sprzedawcę indywidualnego.W wartościach
external_seller_idrozróż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 ~. |