Usługa lokalnego asortymentu pozwala tworzyć i aktualizować instancje zasobów lokalnego asortymentu, które zawierają pola o różnych wartościach dla różnych lokalizacji sklepów stacjonarnych. Każda instancja lokalnego asortymentu produktów jest elementem podrzędnym istniejącego zasobu produktu i dziedziczy pola danych produktu z zasobu nadrzędnego. Może się np. zdarzyć, że produkt ma różną cenę i ilość w różnych sklepach, ale ma taki sam identyfikator, opis i inne dane produktu we wszystkich sklepach. Dane lokalnego asortymentu są używane w programach Lokalna przestrzeń Google i Reklamy lokalnego asortymentu produktów.
W tym przewodniku wyjaśniamy, czego potrzebujesz przed rozpoczęciem korzystania z usługi lokalnego asortymentu, opisujemy dostępne pola i metody oraz pokazujemy przykład żądania usługi.
Wymagania wstępne
- Aby korzystać z usługi lokalnego asortymentu, musisz utworzyć profil firmy, połączyć go z kontem Merchant Center, zgłosić firmę do weryfikacji i skonfigurować kody sklepów w profilu firmy.
Twoje konto Merchant Center musi być zarejestrowane w programie lokalnym: Lokalna przestrzeń Google lub Reklamy lokalnego asortymentu produktów. Więcej informacji o korzystaniu z reklam lokalnego asortymentu produktów za pomocą Content API znajdziesz w artykule Pierwsze kroki z reklamami lokalnego asortymentu produktów.
Usługa lokalnego asortymentu tworzy wystąpienia lokalnego asortymentu dla istniejących produktów dostępnych lokalnie. Najpierw musisz utworzyć produkty dostępne lokalnie, korzystając z usługi Content API products lub za pomocą plików danych w Merchant Center, ustawiając w polu
channel
wartośćlocal
. Następnie możesz za pomocą usługi lokalnego asortymentu produktów utworzyć instancje lokalnego asortymentu produktów dla każdego profilu firmystorecode
, w którym sprzedajesz produkt.
Pola
Każde wystąpienie lokalnego asortymentu produktów zawiera zestaw pól powiązanych z konkretną lokalizacją sklepu za pomocą pola storeCode
(które określasz w profilu firmy). W przypadku wszystkich żądań wymagane są tylko metody storecode
i productId
. Wszystkie pozostałe pola są opcjonalne:
- Wymagane dla wszystkich żądań:
storeCode
,productId
(w adresie URL) - Opcjonalnie:
quantity
,price
,salePrice
,salePriceEffectiveDate
,availability
,pickupMethod
,pickupSla
,instoreProductLocation
Pełną listę pól lokalnego asortymentu i ich opisy znajdziesz na stronie z informacjami o lokalnym asortymencie.
Metody
Usługa lokalnego asortymentu produktów obejmuje tylko 2 metody:
localinventory.insert
localinventory.insert
umożliwia utworzenie instancji lokalnego asortymentu dla jednego produktu dostępnego lokalnie.
Ten przykład pokazuje, jak za pomocą usługi lokalnego asortymentu produktów utworzyć wyprzedaż w sklepie od 13:00 (GMT-8) 24 lutego 2021 r. do godz. 15:30 (GMT-8) za pomocą usługi lokalnego asortymentu produktów. Żądanie aktualizuje też ilość dostępną w wystąpieniu lokalnego asortymentu. W odróżnieniu od dodatkowych plików danych w przypadku danych produktów nielokalnych pola, które nie zostały uwzględnione w treści żądania, są zastępowane tym wywołaniem:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory
{
"storeCode": “1235”,
"salePrice": {
"value": “100.00”,
"currency": “USD”
},
"salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
"quantity": 200,
}
localinventory.custombatch
localinventory.custombatch
umożliwia utworzenie wielu instancji lokalnego asortymentu dla jednego produktu dostępnego lokalnie w wielu sklepach lub instancji lokalnego asortymentu dla wielu produktów dostępnych lokalnie.