Эта страница переведена с помощью Cloud Translation API.

Подготовьте свой аккаунт в Merchant Center.

Для бесплатного размещения товаров в вашем аккаунте Merchant Center необходимо иметь действующий аккаунт и одобренные товары. Чтобы начать работу, ознакомьтесь с этими статьями в Справочном центре:

После того, как вы настроите свой Merchant Center с товарами, перед началом интеграции API необходимо выполнить требования, описанные в этом разделе.

1. Настройки Merchant Center

Убедитесь, что в вашем аккаунте Google Merchant Center настроены следующие параметры:

1.1. Политика возврата

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

Если ваш аккаунт в Merchant Center является расширенным , то правила возврата товаров необходимо настроить для каждого отдельного субсчета.

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

1.2. Информация о службе поддержки клиентов

Необходимо указать контактные данные службы поддержки клиентов в Merchant Center. Они будут использованы для генерации ссылки «Связаться с продавцом» на странице подтверждения заказа. Подробнее о настройке контактных данных службы поддержки можно прочитать здесь .

2. Данные о продукте

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

2.1. Право на агентскую проверку

Это позволяет включить товар в процесс оформления заказа в Google.

Эта функция предоставляется с помощью атрибута товара native_commerce содержащего одно логическое значение. Если оно установлено на false или отсутствует, товар не будет доступен для оформления заказа.

2.2. Предупреждения о продукте

Это обязательно для товаров, на которые распространяются нормативные требования по предупреждениям (например, Калифорнийское предложение 65). Вы несете ответственность за соблюдение всех применимых законов, включая требования к предупреждениям на продукции. Эти предупреждения отображаются на видном месте на экране оформления заказа, когда вы их предоставляете.

Добавьте к группе атрибутов consumer_notice два податрибута:

consumer_notice_type : Должен быть одним из следующих значений: legal_disclaimer , safety_warning или prop_65 .
consumer_notice_message : Строка (максимум 1000 символов). Допускаются HTML-теги <b> , <br> и <i> .

2.3. Идентификатор продукта

id в вашем товарном фиде должен совпадать с идентификатором товара, ожидаемым вашим API оформления заказа. Если они совпадают, никаких действий не требуется. В противном случае используйте пользовательский атрибут merchant_item_id для их сопоставления.

2.4. Как добавить атрибуты к вашим товарам

Приведенные ниже примеры демонстрируют различные варианты предоставления продукта в Merchant Center.

2.4.1. Корма

Мы рекомендуем создать дополнительный источник данных ( инструкции здесь ). Вы можете добавить его в свой основной фид, но будьте осторожны, так как неправильное форматирование может повлиять на регулярное поступление продуктов.

Примечание по синтаксису: Убедитесь, что сложные строки (например, сообщение Prop 65) не содержат символов, нарушающих формат файла (например, лишние запятые в CSV-файле), если они не экранированы должным образом.

Формат текстового файла:

ИДЕНТИФИКАТОР	native_commerce	потребительское уведомление
11111	истинный	`prop_65:This product can expose you...`
22222	истинный
33333	ЛОЖЬ

Формат XML:

<item>
  <g:id>11111</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
  <g:consumer_notice>
    <g:consumer_notice_type>prop_65</g:consumer_notice_type>
    <g:consumer_notice_message>
      This product can expose you to chemicals...
    </g:consumer_notice_message>
  </g:consumer_notice>
</item>
<item>
  <g:id>22222</g:id>
  <g:native_commerce>TRUE</g:native_commerce>
</item>
<item>
  <g:id>33333</g:id>
  <g:native_commerce>FALSE</g:native_commerce>
</item>

2.4.2. API контента

Укажите атрибуты как пользовательские атрибуты. Их необходимо включить в метод products.insert , содержащий полный список товаров, поскольку метод products.update не поддерживает обновление пользовательских атрибутов.

Пример:

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

2.4.2. API для продавцов

Укажите атрибуты как пользовательские атрибуты. Вы можете добавить их к существующим объектам accounts.productInputs.insert или обновить их напрямую с помощью accounts.productInputs.patch .

Пример для вставки :

"customAttributes": [
  {
    "name": "native commerce",
    "groupValues": [
      {
        "name": "checkout eligibility",
        "value": "true"
      }
    ]
  },
  {
    "name": "consumer notice",
    "groupValues": [
      {
        "name": "notice type",
        "value": "prop_65"
      },
      {
        "name": "notice message",
        "value": "This product can expose you to chemicals..."
      }
    ]
  },
  {
    "name": "merchant item id",
    "value": "some_checkout_item_id_1"
  }
]

Пример обновления :

Тип	Имя	Ценить
Параметры пути	`productInput.name`	`accounts/{account}/productInputs/en~US~11111`
Параметры запроса	`updateMask`	`customAttributes.native%20commerce,customAttributes.consumer%20notice,customAttributes.product%20fee,customAttributes.merchant%20item%20id`
	`dataSource`	`dataSources/{datasource}`

{
  "offerId": "11111",
  "contentLanguage": "en",
  "feedLabel": "US",
    "customAttributes": [
    {
      "name": "native commerce",
      "groupValues": [
        {
          "name": "checkout eligibility",
          "value": "true"
        }
      ]
    },
    {
      "name": "consumer notice",
      "groupValues": [
        {
          "name": "notice type",
          "value": "prop_65"
        },
        {
          "name": "notice message",
          "value": "This product can expose you to chemicals..."
        }
      ]
    },
    {
      "name": "product fee",
      "groupValues": [
        {
          "name": "product fee type",
          "value": "US_AZ_TIRE_FEE"
        },
        {
          "name": "product fee amount",
          "value": "2.75 USD"
        }
      ]
    },
    {
      "name": "merchant item id",
      "value": "some_checkout_item_id_1"
    }
  ]
}

3. Ограничения на продукцию

Следующие категории товаров недоступны для оформления заказа. Убедитесь, что для этих товаров параметр native_commerce пуст или установлен на false .

Финансовые продукты и модели регулярного выставления счетов

Подписки: продукты, требующие периодической оплаты.
Рассрочка: операции, требующие установленных продавцом планов оплаты или финансирования.

Товары, изготовленные на заказ, и варианты доставки.

Персонализированные товары: изделия, требующие индивидуального дизайна (например, гравировка, монограммы).
Товары, не являющиеся новыми или подлежащие возврату: отремонтированные товары, бывшие в употреблении товары и товары, помеченные как «Безвозмездная продажа» (возврат невозможен).
Товары по предварительному заказу: продукция с будущими датами выпуска и отложенной доставкой.
Комплексные услуги: услуги, требующие заключения дополнительных договоров, такие как гарантия, установка или настройка.
Специальная доставка: товары, требующие нестандартной оплаты за доставку (например, грузовая доставка, экспресс-доставка).
Дарение: операции, требующие разделения счетов на несколько частей или скрытых цен для получателей.
Активация в магазине: товары, которые необходимо физически активировать в торговой точке.

Политика и ограничения безопасности

Товары с возрастными ограничениями: продажа товаров, требующих подтверждения личности (например, алкоголь, табак).
Запрещенный контент: оружие, контент для взрослых, товары медицинского/фармацевтического назначения, контрафактная продукция или любая другая категория, заблокированная стандартной политикой Google Shopping.

Цифровые товары и услуги

Услуги: уроки, онлайн-курсы и туристические пакеты (если не интегрированы с использованием специальных разделов Travel).
Прокат: прокат фильмов, прокат оборудования или лизинг.
Виртуальные предметы: внутриигровая валюта, товары MMORPG или скины.
Программные зависимости: товары, для покупки которых пользователю необходимо установить определенное программное обеспечение.