Pierwsze kroki z interfejsem Merchant API

Z tej strony dowiesz się, jak utworzyć konto Merchant Center i przesłać przykładowy produkt za pomocą Merchant API.

Zanim zaczniesz

włączyć Merchant API w projekcie Google Cloud,

Jeśli używasz integracji interfejsu API w AppScript za pomocą usługi treści w Zakupach Google, domyślnie tworzony jest projekt Google Cloud i automatycznie włączana jest usługa Merchant API. Zanim zaczniesz korzystać z Merchant API, musisz jednak zarejestrować się jako deweloper. Więcej informacji znajdziesz w artykule Korzystanie z usługi Merchant API w Apps Script.

Otwórz Google Cloud

Utwórz konto

Aby korzystać z Merchant API, musisz mieć konto Merchant Center. Aby utworzyć konto, zapoznaj się z artykułem Pierwsze kroki z Merchant Center.

Otwórz Merchant Center

Zarejestruj się jako programista

Aby korzystać z Merchant API, musisz utworzyć połączenie między projektem Google Cloud a głównym kontem Merchant Center. Ta jednorazowa rejestracja jest wymagana w przypadku każdego projektu Google Cloud, którego używasz z Merchant API.

Rejestracja jako deweloper ma 2 cele:

  • Łączy on Twój projekt Google Cloud z głównym kontem Merchant Center, tworząc formalne połączenie.
  • Tworzy osobę kontaktową ds. technicznych, przypisując API_DEVELOPER rolę użytkownikowi na Twoim koncie Merchant Center. Dzięki temu Google może wysyłać Ci ważne aktualizacje dotyczące interfejsu API, takie jak powiadomienia o usługach i informacje o nowych funkcjach.

Rejestrowanie projektu Google Cloud

Aby zarejestrować urządzenie, wywołaj metodę developerRegistration.registerGcp. To wywołanie łączy projekt Google Cloud, którego używasz do wywoływania, z kontem Merchant Center określonym w żądaniu.

W treści prośby musisz podać adres e-mail dewelopera, który będzie używany jako kontakt techniczny. Ten adres musi być powiązany z kontem Google (kontem Google Workspace lub kontem Gmail), np. sampleuser@gmail.com.

  • Jeśli adres e-mail należy już do użytkownika na koncie Merchant Center, otrzyma on rolę API_DEVELOPER.
  • Jeśli adres e-mail nie należy do istniejącego użytkownika, na ten adres zostanie wysłane zaproszenie. Aby zostać dodanym jako nowy użytkownik z rolą API_DEVELOPER, odbiorca musi zaakceptować zaproszenie.

Oto przykładowe żądanie:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Wywołanie zakończone pomyślnie zwraca zasób DeveloperRegistration, który potwierdza połączenie między Twoim projektem a kontem.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

Zarządzanie kontaktami dewelopera i uprawnieniami

Po rejestracji zalecamy dodanie kilku deweloperów i przyznanie im dodatkowych praw dostępu.

Przyznawanie dodatkowych uprawnień

Rola API_DEVELOPER jest wymagana do otrzymywania ważnych powiadomień, ale ma minimalne uprawnienia w Merchant Center. Aby umożliwić temu użytkownikowi wykonywanie innych wywołań interfejsu API lub zarządzanie ustawieniami w interfejsie Merchant Center, musisz przyznać mu dodatkowe role, takie jak STANDARD lub ADMIN. Więcej informacji znajdziesz w artykule Rodzaje dostępu.

Uprawnienia dostępu użytkownika możesz zaktualizować za pomocą metody accounts.users.patch.

Poniższy przykład pokazuje, jak zaktualizować użytkownika, aby przyznać mu role ADMIN i API_DEVELOPER. Dzięki temu będzie mógł w pełni zarządzać kontem i otrzymywać komunikaty dotyczące interfejsu API.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Dodawanie deweloperów zapasowych

Aby zapobiec przerwaniu dostępu do interfejsu API w przypadku, gdy główna osoba kontaktowa dewelopera opuści Twoją organizację, dodaj co najmniej jednego dewelopera rezerwowego.

Użytkownika możesz dodać za pomocą metody accounts.users.create lub zaktualizować istniejącego za pomocą metody accounts.users.patch. Zalecamy przyznanie temu użytkownikowi ról ADMIN i API_DEVELOPER.

Tworzenie podstawowego źródła danych o produktach

Aby wstawić produkt, musisz mieć podstawowe źródło danych o produktach. Poniższa prośba pokazuje, jak utworzyć źródło danych, którego możesz użyć do wstawienia produktu na konto:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

Zastąp symbol {ACCOUNT_ID} identyfikatorem utworzonego konta Merchant Center.

Po pomyślnym uruchomieniu tego żądania powinna pojawić się taka odpowiedź:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Skopiuj wartość pola name. Będzie on potrzebny do wstawienia produktu.

To źródło danych możesz wyświetlić w interfejsie Merchant Center. Więcej informacji znajdziesz w artykule Jak znaleźć kartę Źródła danych.

Wstaw produkt

Aby wstawić przykładowy produkt na konto, uruchom to żądanie:

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "channel": "ONLINE",
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

Zastąp {DATASOURCE_NAME} skopiowaną wcześniej wartością.

Po pomyślnym uruchomieniu tego żądania powinna pojawić się taka odpowiedź:

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

Identyfikator nowo utworzonego produktu to online~en~US~tshirt-123. Aby pobrać szczegóły tego produktu, możesz użyć metody accounts.products.get. Możesz też wyświetlić ten produkt w interfejsie Merchant Center. Zobacz Wyświetlanie danych produktów.

Wstecz
Design
Dalej
Overview