Z tej strony dowiesz się, jak utworzyć konto Merchant Center i przesłać przykładowy produkt za pomocą interfejsu Merchant API.
Zanim zaczniesz
Włącz Merchant API w projekcie Google Cloud.
Utwórz konto
Aby korzystać z interfejsu Merchant API, musisz mieć konto Merchant Center. Aby utworzyć konto Merchant Center, zapoznaj się z artykułem Pierwsze kroki z Merchant Center.
Uzyskiwanie identyfikatora konta
Identyfikator konta możesz uzyskać, korzystając z metody accounts.list.
Aby wysyłać żądania do Merchant API, możesz użyć narzędzia Google APIs Explorer. Interfejs APIs Explorer używa protokołu Google OAuth 2.0 do uwierzytelniania. Zanim uruchomisz żądania, upewnij się, że zaznaczone jest pole wyboru Google OAuth 2.0.
Aby uwierzytelnić się za pomocą OAuth 2.0, musisz zalogować się na swoje konto Google, a następnie zalogować się w usłudze APIs Explorer. Musisz też zezwolić interfejsowi API Explorer na zarządzanie informacjami o produktach i kontami.
Aby pobrać identyfikator konta, wyślij to żądanie:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
Po pomyślnym uruchomieniu żądania wyświetli się taka 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ędziesz go potrzebować do wykonywania innych żądań.
Tworzenie podstawowego źródła danych o produktach
Aby wstawić produkt, musisz mieć podstawowe źródło danych o produktach. Poniższe żądanie pokazuje, jak utworzyć źródło danych, za pomocą którego można wstawić produkt 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 {ACCOUNT_ID} identyfikatorem utworzonego przez siebie konta Merchant Center.
Po pomyślnym wykonaniu tego żądania otrzymasz 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ędziesz jej potrzebować 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 sekcji Jak znaleźć kartę Źródła danych.
Wstaw produkt
Aby wstawić na konto przykładowy produkt, 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 wykonaniu tego żądania otrzymasz 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 Merchant Center.