Omówienie interfejsu Merchant API

Na tej stronie znajdziesz wprowadzenie do Merchant API oraz informacje o tym, jak za jego pomocą automatyzować różne przepływy pracy związane z zarządzaniem kontami, produktami i zapasami w Merchant Center.

Korzystając z Merchant API, możesz docierać do większej liczby klientów i prezentować swoje produkty w Google. Interfejs Merchant API możesz używać do zarządzania dużymi lub złożonymi kontami Merchant Center. Oto kilka typowych przypadków użycia:

  • Automatyczne zarządzanie kontem
  • Automatyczne zarządzanie produktami
  • Automatyczne zarządzanie asortymentem
  • Raportowanie niestandardowe

Interfejs Merchant API umożliwia tworzenie wielu źródeł danych i zarządzanie nimi, co pozwala lepiej organizować informacje o produktach, promocjach i opiniach. Dzięki Merchant API możesz zarządzać produktami w sposób uzupełniający inne metody przesyłania danych o produktach, takie jak pliki i automatyczny plik danych.

Interfejs Merchant API to przeprojektowana wersja interfejsu Content API for Shopping. Składa się on z wielu podstawowych interfejsów API.

Sprzedawcy są odpowiedzialni za przestrzeganie zasad dotyczących reklam produktowych i bezpłatnych informacji. Google Shopping zastrzega sobie prawo do egzekwowania tych zasad i podejmowania odpowiednich działań, jeśli wykryjemy treści lub zachowania, które je naruszają.

Co nowego w Merchant API

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

Więcej informacji znajdziesz w artykule Nowe funkcje wprowadzone w Merchant API (wersja beta).

Zanim rozpoczniesz

Aby wykonać żądanie interfejsu Merchant API, musisz mieć:

  • konto Merchant Center: konto, na którym będziesz wysyłać zapytania, aktualizować i przesyłać dane; Upewnij się, że masz wymagane uprawnienia do zarządzania produktami i asortymentem na tym koncie.

  • projekt Google Cloud: służy do uzyskiwania dostępu do interfejsu API na Twoim koncie;

Uwierzytelnianie za pomocą interfejsu Merchant API

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

  • Możesz wygenerować identyfikator klienta i tajny klucz OAuth 2.0 dla swojej aplikacji. Następnie możesz użyć identyfikatora i tajnego klucza do wygenerowania danych uwierzytelniających OAuth 2.0 potrzebnych do wywołania interfejsu API na koncie Merchant Center.
  • Aby wykonywać wywołania interfejsu API, możesz utworzyć konto usługi i pobrać jego klucz prywatny.

Identyfikatory konta i produktu

Interfejs Merchant API używa do identyfikacji naz zasobów zamiast identyfikatorów. Przykładowa nazwa zasobu usługi może mieć postać accounts/123456/products/online~en~US~sku123, gdzie 123456 to unikalny identyfikator konta, a online~en~US~sku123 to unikalny identyfikator usługi.

Format adresu URL żądania

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}

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

Na przykład to zapytanie usuwa asortyment regionalny:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/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}

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

POST https://merchantapi.googleapis.com/accounts/v1beta/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 referencyjnej interfejsu Merchant API.

Pierwsze kroki z interfejsem Merchant API

Aby szybko sprawdzić, jak działa interfejs Merchant API, i przetestować przesyłanie przykładowego produktu, zapoznaj się z artykułem Pierwsze kroki z interfejsem 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.

Korzystanie z bibliotek klienta i przykładowych fragmentów kodu

Każdy interfejs podrzędny ma biblioteki klienta, które pomogą Ci zacząć. Przykładowe fragmenty kodu mogą Ci pomóc w rozpoczęciu tworzenia kodu w językach Java, PHP i Python. Więcej informacji znajdziesz w przykładach kodu Merchant API.

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: utwórz zgłoszenie w repozytorium GitHub dotyczącym przykładów kodu.

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

Co dalej?

Dalej
Projektowanie