Zgodność Content API for Shopping

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.

Uwaga: ze względu na lepszy wygląd nie możemy zagwarantować pełnej zgodności wstecznej podobnych funkcji interfejsu Content API for Shopping i Merchant API. Na przykład nazwy pól lub dostępność metod mogą się różnić w przypadku tego samego zasobu w Content API for Shopping i Merchant API.

Żą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.

Ważne: zalecamy używanie wartości z pola name bezpośrednio w wywołaniach zamiast analizowania nazwy zasobu lub ręcznego tworzenia nazwy, co pozwoli uniknąć problemów.

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

Uwaga: do 13 listopada 2023 r. interfejs Merchant API będzie zwracać identyfikatory bez wartości channel. Po 13 listopada wszystkie wywołania zwracają pełny identyfikator zasobu. Do 1 lutego 2024 r. musisz używać w wywołaniach pełnego identyfikatora zasobu, w tym channel.

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.