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 integracja interfejsu API jest używana w AppScript za pomocą usługi Content API for Shopping, tworzy domyślny projekt Google Cloud i automatycznie włącza usługę 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.
Utwórz konto
Aby korzystać z interfejsu Merchant API, musisz mieć konto Merchant Center. Aby utworzyć konto Merchant Center, zapoznaj się z artykułem Rozpoczynanie korzystania z Merchant Center.
Zarejestruj się jako programista
Aby korzystać z Merchant API, musisz połączyć konto Merchant Center z projektem Google Cloud za pomocą metody rejestracji dewelopera w ten sposób:
Połącz Merchant Center z projektem Google Cloud: połączenie jest zatwierdzane automatycznie, ponieważ wywołujący ma prawidłowy token dostępu lub klucz interfejsu API z projektu Google Cloud i jest autoryzowanym użytkownikiem konta Merchant Center.
Dodaj użytkownika interfejsu API Developer do konta Merchant Center: interfejs API rejestracji dodaje użytkownika interfejsu API Developer do konta Merchant Center. Jeśli użytkownik już istnieje, otrzyma nowy typ dostępu. W przypadku nowego użytkownika otrzyma on e-maila z zaproszeniem do Merchant Center.
Zalecamy używanie metody accounts.users.create, aby dodawać dodatkowych lub zapasowych programistów interfejsu API. Dzięki temu w przypadku odejścia lub usunięcia osoby z organizacji nadal będziesz mieć ważną rejestrację programisty.
Po rejestracji możesz sprawdzić jej stan za pomocą
GetDeveloperRegistration lub wyrejestrować urządzenie za pomocą UnregisterGCP.
Połączenie rejestracyjne jest
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
Po pomyślnym uruchomieniu żądania otrzymasz odpowiedź:
{
"developerRegistration": {
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
}
}
Po zarejestrowaniu dewelopera interfejsu API możesz użyć metody
accounts.users.patch
do przyznania mu dodatkowych ról, takich jak STANDARD i ADMIN.
Uzyskiwanie identyfikatora konta
Identyfikator konta możesz uzyskać za pomocą metody accounts.list.
Do uruchamiania żądań interfejsu Merchant API możesz używać narzędzia Google APIs Explorer. APIs Explorer używa do uwierzytelniania protokołu Google OAuth 2.0. Zanim uruchomisz żądania, upewnij się, że pole wyboru Google OAuth 2.0 jest zaznaczone.
Aby uwierzytelnić się za pomocą OAuth 2.0, musisz zalogować się na konto Google, a następnie w API Explorer. Musisz też zezwolić narzędziu APIs Explorer na zarządzanie informacjami o produktach i kontami.
To żądanie pokazuje, jak pobrać identyfikator konta:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
lub
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
Po pomyślnym uruchomieniu żądania zobaczysz tę odpowiedź:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Skopiuj {ACCOUNT_ID}, ponieważ będzie Ci potrzebny do uruchamiania innych żądań.
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 swoje konto:
POST https://merchantapi.googleapis.com/datasources/v1beta/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 zobaczysz taką 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, ponieważ będzie ona potrzebna do wstawienia produktu.
Utworzone źródło danych będzie dostępne do wstawiania produktów po kilku minutach.
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/v1beta/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 zobaczysz taką 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.