Usługa lokalnego asortymentu produktów

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 na local. Następnie możesz za pomocą usługi lokalnego asortymentu utworzyć instancje lokalnego asortymentu dla każdego profilu firmy storecode, 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.