Omówienie interfejsu Merchant API

Za pomocą interfejsu Merchant API możesz:

  • zarządzać sposobem, w jaki informacje o Twojej firmie i produktach wyświetlają się w Google;
  • Uzyskaj zautomatyzowany dostęp do danych, statystyk i wyjątkowych możliwości.
  • Rozwijaj firmę i docieraj 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 to:

  • Automatyczne zarządzanie kontami
  • Automatyczne zarządzanie produktami
  • Automatyczne zarządzanie asortymentem
  • Automatyczne zarządzanie raportami dotyczącymi skuteczności i statystyk 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 API sprzedawcy pozwala też na równoległe wykonywanie wielu pojedynczych żądań.

Merchant API to przeprojektowana wersja Content API for Shopping. Składa się z kilku interfejsów sub-API.

Nowości w Merchant API

Oto kilka powodów, dla których warto przejść na 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. Sprawdź, czy 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 z konta Merchant Center z projektem Google Cloud. Utwórz link, wywołując metodę rejestracji dewelopera. Będziesz używać tego konta i tych użytkowników do komunikacji dotyczącej integracji interfejsu API, ankiet i możliwości.

  • Połącz konto Merchant Center z projektem Google Cloud, rejestrując się jako programista. 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 w wywołaniach interfejsu API na konto Merchant Center.
  • Aby wywoływać interfejs API, możesz utworzyć konto usługi i pobrać jego klucz prywatny.

Identyfikatory konta i produktu

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 wykonać operację na zasobie, wyślij żądania na adresy URL w tym formacie:

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

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

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 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 Merchant API, i spróbować przesłać przykładowy produkt, zapoznaj się z artykułem Pierwsze kroki z interfejsem API sprzedawcy.

Używanie gRPC lub REST

Merchant API obsługuje gRPC i REST. Wywołania interfejsu API sprzedawcy można wykonywać na 2 sposoby:

gRPC (zalecane) REST
  1. Utwórz treść żądania jako bufor protokołu.
  2. Wyślij treść żądania na serwer 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 go na serwer za pomocą protokołu HTTP 1.1.
  3. Zdeserializuj odpowiedź jako obiekt JSON.
  4. Zinterpretuj wyniki.

Korzystanie z bibliotek klienta i przykładowych kodów

Każdy interfejs API ma biblioteki klienta, które pomogą Ci rozpocząć pracę. Przykładowe fragmenty kodu mogą pomóc Ci w rozpoczęciu pisania kodu w językach Java, PHP i Python. Więcej informacji znajdziesz w artykule Przykłady dotyczące interfejsu Merchant API.

Pomoc

Informacje o tym, jak uzyskać pomoc, 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? w formularzu opinii wybierz opcję Prześlij opinię.
  • Dokumentacja: użyj ocen w postaci kciuków na stronie i przycisku Prześlij opinię.
  • Przykłady i biblioteki: utwórz zgłoszenie w repozytorium GitHub dla przykładowych fragmentów kodu.

Co dalej?

  • Informacje o zgodności wstecznej znajdziesz w artykule Zgodność Content API for Shopping.

  • Więcej informacji o najważniejszych funkcjach Merchant API znajdziesz w przewodnikach w menu nawigacyjnym po lewej stronie.

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

Wstecz
Latest updates
Dalej
Design