Korzystając z tego przewodnika, możesz zintegrować interfejs Merchant API z bieżącej implementacji interfejsu Content API for Shopping.
Rozpocznij
Zapoznaj się z projektem interfejsu Merchant API, aby uzyskać szczegółowe informacje na temat Interfejs Merchant API i jego podrzędne interfejsy API.
Aby zacząć korzystać z interfejsu Merchant API, zmień adresy URL żądań na format:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Zapoznaj się z krótkim przewodnikiem i w dokumentacji interfejsu Merchant API znajdziesz więcej informacji.
Obsługa gRPC
Interfejs Merchant API obsługuje gRPC i REST. Za pomocą gRPC dla interfejsu Merchant API i REST dla Content API for Shopping jednocześnie obecnie się znajdujesz.
Biblioteki klienta interfejsu Merchant API wymagają gRPC.
Więcej informacji znajdziesz w sekcji o używaniu gRPC. i informacjami o nich.
Zgodność
W tym przewodniku opisujemy ogólne zmiany, które dotyczą całego interfejsu Merchant API. Zobacz te przewodniki dotyczące zmian poszczególnych obiektów:
- 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ącym interfejsem Content API for Shopping. wersji 2.1.
Możesz na przykład używać interfejsu Merchant Inventories API
Zasoby reklamowe w Content API for Shopping w wersji 2.1
products. Ty
może skorzystać z interfejsu Content API for Shopping, aby przesłać nowy plik lokalnych
(produkt, który sprzedajesz
w lokalnym sklepie), a następnie użyj interfejsu Merchant Inventories API.
LocalInventory.
do zarządzania informacjami o danym produkcie w sklepie.
Żądania zbiorcze
Interfejs Merchant API nie obsługuje metody customBatch omówionej w
Content API for Shopping. Zamiast tego zapoznaj się z sekcją Wysyłanie grupowe
. Jeśli korzystasz z usług customBatch,
potrzebujesz tej funkcji w interfejsie Merchant API, daj nam znać w
opinii.
Identyfikatory
Aby dostosować się do zasad Google dotyczących ulepszania interfejsów API, wprowadziliśmy wprowadzono zmiany 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 odczytu i
zapisz wywołania w interfejsie Merchant API.
Wartość zwracana w polach name ma nowy format identyfikatora.
Zaimplementuj na przykład metodę getName(), aby pobrać name z
i zapisywać dane wyjściowe jako zmienną, zamiast konstruować name.
z 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 ~ między każdą wartością w identyfikatorze:
channel:language:feedLabel:offerId
Wszystkie wywołania interfejsu Merchant API zwracają nowy format z ~ między wartościami
ID. Zalecamy zapisanie nowego formatu z odpowiedzi i użycie go w
.
pola nadrzędne zasobów podrzędnych
W interfejsie Merchant API wszystkie zasoby podrzędne mają pole parent. Za pomocą
pole parent do określenia name zasobu, do którego ma zostać wstawiony element podrzędny,
zamiast przekazywać cały zasób nadrzędny. Możesz też użyć usługi parent
z metodami list do wyświetlania listy zasobów podrzędnych obiektu parent.
Aby na przykład wyświetlić lokalny asortyment danego produktu, określ atrybut
name produktu w sekcji
parent
dla wartości
list
. W tym przypadku wartość product to parent argumentu
LocalInventory.
zwróconych zasobów.
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 1 mln mikro
w wysokości standardowej jednostki 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.
to ISO 4217.