- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- Попробуйте!
Загружает информацию о продукте в ваш аккаунт Merchant Center. Если входные данные с тем же ContentLanguage, OfferId и DataSource уже существуют, этот метод заменяет эту запись.
После вставки, обновления или удаления ввода продукта может пройти несколько минут, прежде чем обработанный продукт сможет быть получен.
HTTP-запрос
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
parent | Необходимый. Аккаунт, в который будет добавлен этот товар. Формат: аккаунты/{аккаунт} |
Параметры запроса
Параметры | |
---|---|
dataSource | Необходимый. Имя основного или дополнительного источника данных о продукте. Если продукт уже существует и указанный источник данных отличается, продукт будет перемещен в новый источник данных. Формат: |
Тело запроса
Тело запроса содержит экземпляр ProductInput
.
Тело ответа
Этот ресурс представляет входные данные, которые вы отправляете для продукта, а не обработанный продукт, который вы видите в Merchant Center, в товарных объявлениях или на платформах Google. Входные данные о продукте, правила и дополнительные данные источника данных объединяются для создания обработанного [продукта][google.shopping.content.bundles.Products.Product].
Требуемые входные атрибуты продукта для прохождения проверок достоверности данных в первую очередь определяются в Спецификации данных о продуктах .
Обязательны следующие атрибуты: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] и [offerId][google.shopping.content. Bundles.Products.offer_id].
После вставки, обновления или удаления ввода продукта может пройти несколько минут, прежде чем обработанный продукт сможет быть получен.
Все поля ввода продукта и его подсообщения соответствуют английскому названию соответствующего атрибута в вертикальной спецификации, за некоторыми исключениями .
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{ "name": string, "product": string, "channel": enum ( |
Поля | |
---|---|
name | Идентификатор. Имя входного продукта. Формат: |
product | Только вывод. Название обрабатываемого продукта. Формат: |
channel | Необходимый. Неизменяемый. Канал продукта. |
offerId | Необходимый. Неизменяемый. Ваш уникальный идентификатор продукта. Это то же самое для входного продукта и обработанного продукта. Ведущие и конечные пробелы удаляются, а несколько пробелов заменяются одним пробелом при отправке. Подробную информацию см. в технических характеристиках продукта . |
contentLanguage | Необходимый. Неизменяемый. Двухбуквенный языковой код продукта по стандарту ISO 639-1 . |
feedLabel | Необходимый. Неизменяемый. Этикетка фида продукта. |
attributes | Необязательный. Список атрибутов продукта. |
customAttributes[] | Необязательный. Список пользовательских атрибутов (предоставленных продавцом). Его также можно использовать для отправки любого атрибута спецификации данных в его общей форме (например, |
versionNumber | Необязательный. Представляет существующую версию (свежесть) продукта, которую можно использовать для сохранения правильного порядка при одновременном выполнении нескольких обновлений. Если этот параметр установлен, вставка предотвращается, если номер версии меньше текущего номера версии существующего продукта. Повторную установку (например, обновление продукта через 30 дней) можно выполнить с текущим Поддерживается только для вставок в первичные источники данных. Если операция предотвращена, будет выброшено прерванное исключение. |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/content
Дополнительную информацию см. в обзоре OAuth 2.0 .