Usługa lokalnego asortymentu produktów umożliwia tworzenie i aktualizowanie instancji zasobu lokalnego asortymentu, które zawierają pola o różnych wartościach dla różnych lokalizacji sklepów stacjonarnych. Każde wystąpienie lokalnego asortymentu jest podrzędne wobec istniejącego zasobu produktu i dziedziczy pola danych produktów z zasobu nadrzędnego. Załóżmy, że masz produkt z różną ceną i liczbą sztuk w różnych sklepach, ale ten sam identyfikator, opis i inne dane produktu we wszystkich sklepach. Dane o lokalnym asortymencie są używane w programach Lokalna przestrzeń Google i Reklam lokalnego asortymentu produktów.
Z tego przewodnika dowiesz się, co jest potrzebne, zanim zaczniesz korzystać z usługi lokalnego asortymentu produktów, a także poznasz dostępne pola i metody. Znajdziesz tu też przykład zapytania o usługę.
Wymagania wstępne
- Aby korzystać z usługi lokalnego asortymentu produktów, 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: w przestrzeni Google lokalnej lub reklamach 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 instancje lokalnego asortymentu dla istniejących produktów dostępnych lokalnie. Najpierw musisz utworzyć produkty dostępne lokalnie za pomocą usługi produkty w Content API lub plików danych w Merchant Center, ustawiając pole
channel
nalocal
. Następnie możesz za pomocą usługi lokalnego asortymentu utworzyć instancje lokalnego asortymentu dla każdego profilu firmystorecode
, w którym sprzedawany jest produkt.
Pola
Każde wystąpienie lokalnego asortymentu zawiera zbiór pól powiązanych z konkretną lokalizacją sklepu za pomocą pola storeCode
(którego określasz w profilu swojej firmy). W przypadku wszystkich żądań wymagane są tylko znaczniki 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 opisów znajdziesz na stronie z informacjami o localinventory.
Metody
Usługa lokalnego asortymentu produktów obejmuje tylko 2 metody:
localinventory.insert
localinventory.insert
umoż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. od godz. 13:00 (GMT-8) do 28 lutego 2021 r. do godz. 15:30 (GMT-8). W żądaniu zaktualizujesz też ilość dostępną dla instancji lokalnego asortymentu. W przeciwieństwie do dodatkowych plików danych w przypadku danych o produktach innych niż lokalne pola, które nie znajdują się 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
pozwala utworzyć wiele instancji lokalnego asortymentu dla jednego produktu lokalnego w wielu sklepach lub utworzyć instancje lokalnego asortymentu dla wielu produktów dostępnych lokalnie.