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ładową nazwą zasobu produktu może być accounts/123/products/online~en~US~sku123, gdzie 123 to unikalny identyfikator konta, a online~en~US~sku123 to unikalny identyfikator produktu.

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 referencyjnej interfejsu 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

Więcej informacji o korzystaniu z pomocy znajdziesz w artykule Uzyskiwanie pomocy dotyczącej interfejsu 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ę.
  • Sample i biblioteki: kliknij przycisk New issue (Nowy problem) w GitHubie.

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