На этой странице объясняется, как создать учетную запись Merchant Center и загрузить образец товара с помощью Merchant API.
Прежде чем начать
Включите Merchant API в вашем проекте Google Cloud.
Если интеграция API используется в AppScript с использованием Shopping Content Service, создаётся проект Google Cloud по умолчанию и автоматически включается сервис Merchant API. Однако перед использованием Merchant API вам всё равно потребуется пройти однократную регистрацию разработчика. Подробнее см. в разделе «Использование сервиса Merchant API в Apps Script» .
Завести аккаунт
Для использования Merchant API вам потребуется учётная запись Merchant Center. Чтобы создать учётную запись Merchant Center, см. раздел «Начало работы с Merchant Center» .
Зарегистрируйтесь как разработчик
Чтобы использовать API Merchant, необходимо связать свою учетную запись Merchant Center и свой проект Google Cloud, используя метод регистрации разработчика, как указано ниже:
Свяжите Merchant Center и свой проект Google Cloud: связь одобряется автоматически, поскольку у вызывающего абонента есть действительный токен доступа или ключ API из проекта Google Cloud, и он является авторизованным пользователем учетной записи Merchant Center.
Добавление пользователя-разработчика API в учётную запись Merchant Center: API регистрации добавляет пользователя-разработчика API в учётную запись Merchant Center. Если пользователь уже существует, ему будет предоставлен новый тип доступа. В случае добавления нового пользователя он получит электронное письмо с приглашением от Merchant Center.
Мы рекомендуем вам использовать метод accounts.users.create
для добавления дополнительных или резервных разработчиков API, чтобы убедиться, что в случае, если человек покинет вашу организацию или будет удален, у вас все равно останется действующая регистрация разработчика.
После регистрации вы можете просмотреть статус регистрации с помощью GetDeveloperRegistration
или отменить регистрацию с помощью UnregisterGCP
.
Регистрационный звонок
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp
{
developer_email:"example-email@example.com"
}
После успешного выполнения запроса ожидайте ответ:
{
"developerRegistration": {
"name": "accounts/ACCOUNT_ID/developerRegistration",
"gcpIds": ["GOOGLE_CLOUD_PROJECT_ID"]
}
}
После регистрации разработчика API вы можете использовать метод accounts.users.patch
, чтобы предоставить ему дополнительные роли, такие как STANDARD
и ADMIN
.
Получите идентификатор вашего аккаунта
Идентификатор учетной записи можно получить, используя метод accounts.list
.
Вы можете использовать Google APIs Explorer для выполнения запросов к API Merchant. APIs Explorer использует Google OAuth 2.0 для аутентификации. Перед выполнением запросов убедитесь, что флажок Google OAuth 2.0 установлен.
Для аутентификации с помощью OAuth 2.0 необходимо войти в свою учётную запись Google, а затем в APIs Explorer. Также необходимо разрешить APIs Explorer управлять вашими товарными листингами и учётными записями.
Следующий запрос показывает, как можно получить идентификатор вашей учетной записи:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts
или
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}
После успешного выполнения запроса вы увидите следующий ответ:
{
"accounts": [
{
"name": "{ACCOUNT_NAME}",
"accountId": "{ACCOUNT_ID}",
"accountName": "{ACCOUNT_DISPLAY_NAME}",
"timeZone": {
"id": "America/Los_Angeles"
},
"languageCode": "en-US"
}
]
}
Скопируйте {ACCOUNT_ID}
так как он понадобится вам для выполнения других запросов.
Создать основной источник данных о продуктах
Для добавления товара вам необходим основной источник данных о товарах. Следующий запрос показывает, как создать источник данных, который можно использовать для добавления товара в вашу учетную запись:
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"
}
Замените {ACCOUNT_ID} на идентификатор созданной вами учетной записи Merchant Center.
После успешного выполнения запроса вы увидите следующий ответ:
{
"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"
}
Скопируйте значение поля name
, так как оно понадобится вам для вставки товара.
Через несколько минут созданный источник данных станет доступен для добавления товаров.
Вы можете просмотреть этот источник данных в пользовательском интерфейсе Merchant Center. Подробнее см. в разделе «Как найти вкладку «Источники данных»» .
Вставьте продукт
Чтобы добавить образец продукта в свою учетную запись, выполните следующий запрос:
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"
}
Замените {DATASOURCE_NAME} значением, скопированным ранее.
После успешного выполнения запроса вы увидите следующий ответ:
{
"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"
}
}
Идентификатор нового товара — online~en~US~tshirt-123
. Вы можете получить информацию об этом товаре с помощью метода accounts.products.get
. Вы также можете просмотреть этот товар через пользовательский интерфейс Merchant Center .