Omówienie interfejsu Merchant API

Dzięki interfejsowi Merchant API możesz:

  • zarządzać sposobem, w jaki informacje o Twojej firmie i produktach wyświetlają się w Google;
  • uzyskać programowy dostęp do danych, statystyk i wyjątkowych możliwości;
  • rozwijać firmę i docierać do większej liczby klientów w Google.

Interfejs Merchant API może zarządzać dużymi lub złożonymi kontami Merchant Center. Typowe przypadki użycia obejmują:

  • automatyczne zarządzanie kontem;
  • automatyczne zarządzanie produktami;
  • automatyczne zarządzanie asortymentem;
  • automatyczne zarządzanie raportami o skuteczności i statystykach rynkowych.

Interfejs Merchant API umożliwia tworzenie wielu źródeł danych i zarządzanie nimi, co pozwala lepiej porządkować informacje o produktach, promocje i opinie. Interfejs Merchant API umożliwia zarządzanie produktami w sposób uzupełniający inne metody przesyłania danych o produktach, takie jak pliki i automatyczne pliki danych. Interfejs Merchant API pozwala też na równoległe wykonywanie wielu pojedynczych żądań.

Interfejs Merchant API to przeprojektowana wersia interfejsu Content API for Shopping. Składa się z kilku podrzędnych interfejsów API.

Co nowego w interfejsie Merchant API

Oto kilka powodów, dla których warto przejść na interfejs Merchant API:

Zanim rozpoczniesz

Aby uruchomić żądanie do interfejsu API sprzedawcy, musisz mieć:

  • Konto Merchant Center: to konto, na które będziesz przesyłać zapytania, aktualizacje i dane. Upewnij się, że masz niezbędne uprawnienia do zarządzania produktami i asortymentem na tym koncie.

  • Projekt Google Cloud: użyj projektu, aby uzyskać dostęp do konta z poziomu interfejsu API.

  • Połączenie między kontem Merchant Center a projektem Google Cloud. Utwórz połączenie, wywołując metodę rejestracji dewelopera. Będziesz używać tego konta i tych użytkowników do komunikacji dotyczącej integracji z interfejsem API, ankiet i możliwości.

  • Połącz konto Merchant Center z projektem w chmurze Google, rejestrując się jako deweloper. Użytkownicy z rolą programisty interfejsu API będą otrzymywać komunikaty dotyczące interfejsu API, w tym obowiązkowe powiadomienia, ankiety dla programistów i informacje o możliwościach.

Uwierzytelnianie z poziomu interfejsu API sprzedawcy

Do uwierzytelniania możesz użyć tych opcji:

  • Możesz wygenerować identyfikator klienta OAuth 2.0 i obiekt tajny dla swojej aplikacji. Identyfikator i obiekt tajny można następnie wykorzystać do wygenerowania danych logowania OAuth 2.0 potrzebnych do wywoływania interfejsu API na koncie Merchant Center.
  • Aby wywoływać interfejs API, możesz utworzyć konto usługi i pobrać jego klucz prywatny.

Identyfikatory kont i produktów

Interfejs Merchant API używa nazw zasobów zamiast identyfikatorów do identyfikacji. Przykładowa nazwa zasobu produktu może wyglądać tak: accounts/123456/products/en~US~sku123, gdzie 123456 to unikalny identyfikator konta, a en~US~sku123 to unikalny identyfikator produktu.

Format adresu URL żądania

Aby pracować z zasobem, wysyłaj żądania do adresów URL w tym formacie:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

W przypadku standardowych metod, takich jak list i get, pomijana jest część :{METHOD}.

Na przykład to żądanie usuwa asortyment regionalny:

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

Aby utworzyć zasób, użyj nazwy zasobu nadrzędnego i tego adresu URL:

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

Na przykład to żądanie pokazuje, jak utworzyć region dla accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Więcej informacji o poszczególnych usługach znajdziesz w dokumentacji referencyjnej interfejsu Merchant API.

Pierwsze kroki z interfejsem Merchant API

Aby szybko sprawdzić, jak działa interfejs Merchant API, i przesłać przykładowy produkt, przeczytaj artykuł Pierwsze kroki z interfejsem Merchant API.

Korzystanie z gRPC lub REST

Interfejs Merchant API obsługuje gRPC i REST. Istnieją 2 sposoby wywoływania interfejsu Merchant API:

gRPC (zalecane) REST
  1. Utwórz treść żądania jako bufor protokołu.
  2. Wyślij treść żądania do serwera za pomocą protokołu HTTP/2.
  3. Zdeserializuj odpowiedź do bufora protokołu.
  4. Zinterpretuj wyniki.
  1. Utwórz treść żądania jako obiekt JSON.
  2. Wyślij ją do serwera za pomocą protokołu HTTP 1.1.
  3. Zdeserializuj odpowiedź jako obiekt JSON.
  4. Zinterpretuj wyniki.

Korzystanie z bibliotek klienta i przykładów kodu

Każdy podrzędny interfejs API ma biblioteki klienta, które pomagają w rozpoczęciu pracy. Przykłady kodu mogą pomóc w rozpoczęciu pisania kodu w językach Java, PHP i Python. Więcej informacji znajdziesz w artykule Przykłady interfejsu Merchant API.

Pomoc

Informacje o uzyskiwaniu pomocy znajdziesz w artykule Uzyskiwanie pomocy dotyczącej interfejsu Merchant API.

Prześlij opinię

Aby przesłać opinię, wykonaj jedną z tych czynności:

  • Funkcje interfejsu API: w sekcji Jaki jest problem lub pytanie? formularza opinii kliknij Prześlij opinię.
  • Dokumentacja: użyj ocen kciukiem na stronie i przycisku Prześlij opinię.
  • Przykłady i biblioteki: Utwórz zgłoszenie w repozytorium GitHub z przykładami kodu.

Co dalej?

  • Informacje o zgodności wstecznej i zgodności z Content API for Shopping.

  • Aby dowiedzieć się więcej o najważniejszych funkcjach interfejsu Merchant API, zapoznaj się z przewodnikami w menu nawigacyjnym po lewej stronie.

  • Informacje o dostępnych zasobach i usługach znajdziesz w dokumentacji.

Dalej
Terms and Conditions