Method: accounts.productInputs.insert

Загружает информацию о продукте в ваш аккаунт Merchant Center. Если входные данные с тем же ContentLanguage, OfferId и DataSource уже существуют, этот метод заменяет эту запись.

После вставки, обновления или удаления ввода продукта может пройти несколько минут, прежде чем обработанный продукт сможет быть получен.

HTTP-запрос

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Необходимый. Аккаунт, в который будет добавлен этот товар. Формат: аккаунты/{аккаунт}

Параметры запроса

Параметры
dataSource

string

Необходимый. Имя основного или дополнительного источника данных о продукте. Если продукт уже существует и указанный источник данных отличается, продукт будет перемещен в новый источник данных. Формат: accounts/{account}/dataSources/{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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Поля
name

string

Идентификатор. Имя входного продукта. Формат: "{productinput.name=accounts/{account}/productInputs/{productinput}}"

product

string

Только вывод. Название обрабатываемого продукта. Формат: "{product.name=accounts/{account}/products/{product}}"

channel

enum ( ChannelEnum )

Необходимый. Неизменный. Канал продукта.

offerId

string

Необходимый. Неизменный. Ваш уникальный идентификатор продукта. Это то же самое для входного продукта и обработанного продукта. Ведущие и конечные пробелы удаляются, а несколько пробелов заменяются одним пробелом при отправке. Подробную информацию см. в технических характеристиках продукта .

contentLanguage

string

Необходимый. Неизменный. Двухбуквенный языковой код продукта по стандарту ISO 639-1 .

feedLabel

string

Необходимый. Неизменный. Этикетка фида продукта.

attributes

object ( Attributes )

Необязательный. Список атрибутов продукта.

customAttributes[]

object ( CustomAttribute )

Необязательный. Список пользовательских атрибутов (предоставленных продавцом). Его также можно использовать для отправки любого атрибута спецификации данных в его общей форме (например, { "name": "size type", "value": "regular" } ). Это полезно для отправки атрибутов, которые явно не предоставляются API, например дополнительных атрибутов, используемых для покупки через Google. Максимально допустимое количество символов для каждого настраиваемого атрибута — 10 240 (представляет собой сумму символов имени и значения). Для каждого продукта можно установить максимум 2500 пользовательских атрибутов общим размером 102,4 КБ. При вставке символы подчеркивания в именах пользовательских атрибутов заменяются пробелами.

versionNumber

string ( int64 format)

Необязательный. Представляет существующую версию (свежесть) продукта, которую можно использовать для сохранения правильного порядка при одновременном выполнении нескольких обновлений.

Если этот параметр установлен, вставка предотвращается, если номер версии меньше текущего номера версии существующего продукта. Повторную установку (например, обновление продукта через 30 дней) можно выполнить с текущим versionNumber .

Поддерживается только для вставок в первичные источники данных.

Если операция предотвращена, будет выброшено прерванное исключение.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .