Omówienie interfejsu Merchant API

Za pomocą interfejsu Merchant API możesz:

  • Zarządzaj sposobem, w jaki informacje o Twojej firmie i jej produktach wyświetlają się w Google.
  • Zapewnia zautomatyzowany dostęp do danych, statystyk i szerokiej gamy wyjątkowych możliwości.
  • Rozwijaj firmę i docieraj do większej liczby klientów w Google.

Interfejs Merchant API umożliwia zarządzanie dużymi lub złożonymi kontami Merchant Center. Typowe przypadki użycia:

  • Automatyczne zarządzanie kontem
  • Automatyczne zarządzanie produktami
  • Zautomatyzowane zarządzanie asortymentem
  • Zarządzanie automatycznymi raportami dotyczącymi skuteczności i trendów 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ń.

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

Co nowego 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 uprawnienia niezbędne do zarządzania produktami i asortymentem na tym koncie.

  • Projekt Google Cloud: projekt służy do uzyskiwania dostępu do konta z poziomu interfejsu API.

  • Połączenie konta Merchant Center z projektem w chmurze 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 deweloper. Użytkownicy z rolą programisty korzystającego z 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 Merchant API

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 mogą być następnie używane do generowania danych uwierzytelniających OAuth 2.0 potrzebnych w wywołaniach interfejsu API do konta Merchant Center.
  • Możesz utworzyć konto usługi i pobrać jego klucz prywatny, aby wykonywać wywołania interfejsu API.

Identyfikatory konta i usługi

Merchant API używa do identyfikacji nazw zasobów zamiast identyfikatorów. 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 do adresów URL w tym formacie:

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/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 konkretnych usługach znajdziesz w dokumentacji 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 Merchant API.

Używanie gRPC lub REST

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

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. wysłać go na serwer przy użyciu protokołu HTTP 1.1.
  3. Zdeserializuj odpowiedź jako obiekt JSON.
  4. Zinterpretuj wyniki.

Korzystanie z bibliotek klienta i przykładowego kodu

Każdy podrzędny interfejs API ma biblioteki klienta, które ułatwiają rozpoczęcie pracy. Przykładowy kod może pomóc Ci rozpocząć pisanie kodu w językach Java, PHP i Python. Więcej informacji znajdziesz w artykule Przykłady Merchant API.

Pomoc

Informacje o tym, jak uzyskać pomoc, znajdziesz w artykule Pomoc dotycząca Merchant API.

Prześlij opinię

Aby przesłać opinię, prześlij jedną z tych informacji:

  • Funkcje interfejsu API: w sekcji Na czym polega problem lub czego dotyczy pytanie? w formularzu opinii wybierz opcję Prześlij opinię.
  • Dokumentacja: użyj ocen na stronie i przycisku Prześlij opinię.
  • Przykłady i biblioteki: zgłoś problem w repozytorium GitHub, w którym znajdują się przykłady kodu.

Co dalej?

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

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

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

Dalej
Merchant API terms and conditions