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 podstawowych interfejsów API.

Każdy podinterfejs API zawiera przykłady kodu i biblioteki klienta, które ułatwią Ci rozpoczęcie pracy.

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

Prześlij prośby

Interfejs Merchant API używa do identyfikacji naz zasobów zamiast identyfikatorów. 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}

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 i tego adresu URL

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Oto jak utworzyć nowy region dla account/123

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

Więcej informacji o konkretnych usługach znajdziesz w dokumentacji Merchant API.

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
  1. Utwórz treść żądania jako bufor protokołu.
  2. Prześlij treść żądania do serwera za pomocą protokołu HTTP/2.
  3. Deserializuj odpowiedź do bufora protokołu.
  4. Zinterpretuj wyniki.
  1. Utwórz treść żądania jako obiekt JSON.
  2. Prześlij je na serwer za pomocą protokołu HTTP 1.1.
  3. Oddeserializuj odpowiedź jako obiekt JSON.
  4. Zinterpretuj wyniki.

Pomoc

Informacje o dostępie do pomocy znajdziesz w artykule Uzyskiwanie pomocy dotyczącej Merchant API.

Przesyłanie opinii

Okres testów beta daje nam możliwość zebrania i przeanalizowania opinii przed udostępnieniem usługi wszystkim użytkownikom. Aby przesłać opinię, wybierz jedną z tych opcji:

  • Funkcje interfejsu API: prześlij formularz opinii.
  • Dokumentacja: użyj ocen na miniaturach na stronie i przycisku Prześlij opinię.
  • Przykłady i biblioteki: kliknij przycisk Nowy problem na GitHubie.

Aby przekazać ogólną opinię po wykonaniu każdego zadania, użyj formularza opinii.