Pierwsze kroki z interfejsem Merchant API

Aby rozpocząć, włącz Merchant API w projekcie Cloud.

Oto jak korzystać z Merchant API:

Korzystanie z bibliotek klientów

Interfejs Merchant API składa się z wielu podrzędnych interfejsów API.

Każdy podrzędny interfejs API zawiera przykładowy kod oraz biblioteki klienta, które ułatwią Ci rozpoczęcie pracy.

Jeśli korzystasz już z interfejsu Content API for Shopping, zapoznaj się z artykułem Zgodność Content API for Shopping

Prześlij prośby

Interfejs Merchant API używa nazw zasobów, a nie identyfikatorów dla danych osobowych. Przykładowa nazwa zasobu usługi może mieć postać accounts/123/products/online~en~US~sku123, gdzie 123 to unikalny identyfikator konta, a online~en~US~sku123 to unikalny identyfikator usługi.

Aby wykonać operację na zasobach, wysyłaj żądania do adresów URL w tym formacie:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}:{method}

Uwaga: w przypadku metod standardowych część :{method} jest pomijana.

Na przykład ta prośba spowoduje usunięcie asortymentu regionalnego:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

Aby utworzyć nowy zasób, możesz użyć nazwy zasobu nadrzędnego oraz ten URL

POST https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name of parent}/{resource}

Tak na przykład można utworzyć nowy region dla: account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Zapoznaj się z dokumentacją interfejsu Merchant API dotyczącą: bardziej szczegółowe informacje o konkretnych usługach.

Używanie gRPC lub REST

Interfejs Merchant API obsługuje protokoły gRPC i REST. Oto 2 sposoby wywoływania interfejsu Merchant API:

gRPC (zalecane)	REST
Utwórz treść żądania jako bufor protokołu. Prześlij treść żądania do serwera za pomocą protokołu HTTP/2. Deserializuj odpowiedź do bufora protokołu. Zinterpretuj wyniki.	Utwórz treść żądania jako obiekt JSON. Prześlij je na serwer za pomocą protokołu HTTP 1.1. Deserializuj odpowiedź jako obiekt JSON. Zinterpretuj wyniki.

Uwaga: jeśli używasz biblioteki klienta, domyślnym mechanizmem transportu jest gRPC. W w większości przypadków nie musisz robić nic oprócz wywołania interfejsu Merchant API lub punktów końcowych do używania gRPC.

Pomoc

Informacje o tym, jak uzyskać pomoc, znajdziesz w artykule Uzyskiwanie pomocy dotyczącej Merchant API.

Przesyłanie opinii

Okres testów beta daje nam możliwość zebrania opinii i podjęcia odpowiednich działań przed udostępnieniem ich wszystkim użytkownikom. Aby przesłać opinię, prześlij jedną z :

• Funkcje interfejsu API: prześlij formularz opinii.
• Dokumentacja: skorzystaj z kciuków na stronie i kliknij Prześlij opinię Przycisk
• Sample i biblioteki: kliknij przycisk New issue (Nowy problem) w GitHubie.

Aby przesłać ogólną opinię po wdrożeniu każdego zadania, skorzystaj z formularza opinii.