Usługa asortymentu lokalnego umożliwia tworzenie i aktualizowanie instancji zasobu asortymentu lokalnego, które zawierają pola mogące mieć różne wartości w przypadku różnych lokalizacji sklepów stacjonarnych. Każda instancja lokalnego asortymentu jest elementem podrzędnym istniejącego zasobu produktu i dziedziczy pola danych produktu z zasobu nadrzędnego. Możesz na przykład mieć produkt, który ma inną cenę i ilość w różnych sklepach, ale ma ten sam identyfikator, opis i inne dane produktu we wszystkich sklepach. Dane o lokalnym asortymencie produktów są wykorzystywane w programach Asortyment lokalny w przestrzeni Google i reklamy lokalnego asortymentu produktów.
Z tego przewodnika dowiesz się, co musisz zrobić, zanim zaczniesz korzystać z usługi lokalnego asortymentu, poznasz dostępne pola i metody oraz zobaczysz 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, zweryfikować firmę 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 Reklamy lokalnego asortymentu produktów – pierwsze kroki.
Usługa lokalnego asortymentu tworzy instancje lokalnego asortymentu dla istniejących produktów dostępnych lokalnie. Musisz najpierw utworzyć produkty dostępne lokalnie, korzystając z usługi Content API products lub plików danych Merchant Center, ustawiając pole
channelnalocal. Następnie możesz użyć usługi lokalny asortyment, aby utworzyć instancje lokalnego asortymentu dla każdego profilu firmystorecode, w którym sprzedawany jest produkt.
Pola
Każda instancja lokalnego asortymentu zawiera zestaw pól powiązanych z konkretną lokalizacją sklepu za pomocą pola storeCode (które definiujesz w Profilu Firmy). W przypadku wszystkich żądań wymagane są tylko parametry
storecode
i
productId. Wszystkie pozostałe pola są opcjonalne:
- Wymagane w przypadku wszystkich żądań:
storeCode,productId(w adresie URL) - Opcjonalnie:
quantity,price,salePrice,salePriceEffectiveDate,availability,pickupMethod,pickupSla,instoreProductLocation
Pełną listę pól asortymentu lokalnego i ich opisów znajdziesz na stronie referencyjnej localinventory.
Metody
Usługa lokalnego asortymentu produktów obejmuje tylko 2 metody:
localinventory.insert
localinventory.insertumożliwia utworzenie instancji lokalnego asortymentu dla pojedynczego produktu dostępnego lokalnie.
Ten przykład pokazuje, jak za pomocą usługi lokalnego asortymentu utworzyć wyprzedaż w sklepie od 24 lutego 2021 r. o godz. 13:00 (GMT-8) do 28 lutego 2021 r. o godz. 15:30 (GMT-8). Żądanie aktualizuje też ilość dostępną w przypadku lokalnego asortymentu. W przeciwieństwie do dodatkowych plików danych dotyczących danych produktów niedostępnych lokalnie, pola, które nie są uwzględnione w treści żądania, są zastępowane przez to wywołanie:
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 tworzenie wielu instancji lokalnego asortymentu dla jednego produktu dostępnego lokalnie w wielu sklepach lub tworzenie instancji lokalnego asortymentu dla wielu produktów dostępnych lokalnie.