Usługa lokalnego asortymentu produktów

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 firmy storecode, 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.