Korzystając z tego przewodnika, możesz zintegrować Merchant API z istniejącą implementacją Content API for Shopping.
Rozpocznij
Szczegółowe informacje o interfejsie Merchant API i jego podrzędnych interfejsach API znajdziesz w projekcie interfejsu Merchant API.
Aby zacząć korzystać z interfejsu Merchant API, zmień adresy URL żądań na ten format:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Więcej informacji znajdziesz w krótkim przewodniku i w dokumentacji interfejsu Merchant API.
Obsługa gRPC
Interfejs Merchant API obsługuje gRPC i REST. Możesz jednocześnie używać gRPC dla interfejsu Merchant API oraz REST dla Content API for Shopping.
Biblioteki klienta interfejsu Merchant API wymagają gRPC.
Więcej informacji znajdziesz w artykule o używaniu gRPC.
Zgodność
W tym przewodniku opisujemy ogólne zmiany, które dotyczą całego interfejsu Merchant API. W tych przewodnikach znajdziesz informacje o zmianach w poszczególnych funkcjach:
- Przenoszenie zarządzania kontami
- Migracja ustawień dostawy
- Migracja zarządzania produktami
- Przenoszenie źródeł danych do zarządzania
- Migracja zarządzania asortymentem
- Przenoszenie zarządzania promocjami
- Migracja zarządzania raportowaniem
- Przenoszenie źródeł konwersji do zarządzania
- Przeniesienie zarządzania współpracą z partnerami w zakresie plików danych o produktach dostępnych lokalnie
Interfejs Merchant API jest przeznaczony do współpracy z istniejącymi funkcjami Content API for Shopping w wersji 2.1.
Możesz na przykład używać interfejsu Merchant Inventories API razem z istniejącymi asortymentami Content API for Shopping w wersji 2.1 i implementacji products
. Możesz użyć interfejsu Content API for Shopping, aby przesłać nowy produkt lokalny (który sprzedajesz w lokalnym sklepie), a następnie użyć zasobu Merchant Inventories API
LocalInventory
, aby zarządzać informacjami o tym produkcie w sklepie.
Żądania zbiorcze
Interfejs Merchant API nie obsługuje metody customBatch
dostępnej w Content API for Shopping. Zamiast tego zapoznaj się z sekcją Wysyłanie żądań zbiorczych. Jeśli korzystasz z usługi customBatch
i potrzebujesz tej funkcji w interfejsie Merchant API, poinformuj nas, dlaczego tak sądzisz, przesyłając opinię.
Identyfikatory
Aby zapewnić zgodność z zasadami Google dotyczącymi ulepszania interfejsu API, wprowadziliśmy kilka zmian w identyfikatorach zasobów interfejsu Merchant API.
nazwa zastępuje identyfikator
Wszystkie zasoby interfejsu Merchant API używają pola name
jako unikalnego identyfikatora.
Oto przykład użycia pola name
w połączeniach:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
To nowe pole name
jest zwracane jako identyfikator zasobu dla wszystkich wywołań odczytu i zapisu w interfejsie Merchant API.
Wartość zwracana w polach name
ma nowy format identyfikatora.
Zaimplementuj na przykład metodę getName()
, która pobiera name
z zasobu i zapisuje dane wyjściowe jako zmienną, zamiast samodzielnie tworzyć wartości name
na podstawie identyfikatorów sprzedawcy i zasobów.
Nowy format identyfikatora
W interfejsie Merchant API identyfikatory zasobów mają następujący format: channel~language~feedLabel~offerId
Zasoby Content API używały wartości :
zamiast ~
dla każdej wartości w identyfikatorze: channel:language:feedLabel:offerId
Wszystkie wywołania interfejsu Merchant API zwracają nowy format z ~
między wartościami identyfikatora. Zalecamy zapisanie nowego formatu z odpowiedzi i użycie go w przyszłych wywołaniach.
pola nadrzędne zasobów podrzędnych
W interfejsie Merchant API wszystkie zasoby podrzędne mają pole parent
. Zamiast przekazywać cały zasób nadrzędny, możesz użyć pola parent
, aby określić name
zasobu, do którego ma zostać wstawiony element podrzędny. Możesz też użyć pola parent
z metodami list
, aby wyświetlić listę zasobów podrzędnych obiektu parent
.
Aby na przykład wyświetlić lokalny asortyment danego produktu, podaj jego name
w polu parent
w metodzie list
. W tym przypadku product
to wartość parent
zwróconych zasobów LocalInventory
.
Typy
Oto kilka typowych typów udostępnianych w podrzędnych interfejsach API Merchant Center.
Cena
Oto zmiany w elemencie Price
w pakiecie Merchant Common:
Content API. | Interfejs API sprzedawcy | |
---|---|---|
Pole kwoty | value:string |
amountMicros:int64 |
Pole waluty | currency:string
|
currencyCode:string |
Kwota Price
jest teraz rejestrowana w mikro, czyli milion mikro to równowartość standardowej jednostki Twojej waluty.
W Content API for Shopping Price
była liczbą dziesiętną w postaci ciągu znaków.
Nazwa pola kwoty została zmieniona z value
na amountMicros
Nazwa pola waluty została zmieniona z currency
na currencyCode
. Format to ISO 4217.