Обзор Merchant API

Вы можете использовать Merchant API, чтобы:

  • Управляйте тем, как информация о вашей компании и товарах показывается в Google.
  • Автоматизируйте доступ к данным, статистике и уникальным функциям.
  • Развивайте бизнес и привлекайте больше клиентов в Google.

Merchant API позволяет управлять крупными или сложными аккаунтами Merchant Center. Примеры использования:

  • Автоматизированное управление аккаунтом
  • Автоматизированное управление товарами
  • Автоматизированное управление инвентарем
  • Автоматизированное управление отчетами об эффективности и тенденциях рынка

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

Merchant API – это обновленная версия Content API for Shopping. Он состоит из нескольких дополнительных API.

Что нового в Merchant API

Вот несколько причин перейти на Merchant API:

Подготовка

Чтобы отправлять запросы к Merchant API, требуется следующее:

  • Аккаунт Merchant Center. Это аккаунт, который вы будете обновлять и в который будете отправлять запросы и данные о товарах. Убедитесь, что у вас есть необходимые разрешения для управления товарами и ассортиментом в этом аккаунте.

  • Облачный проект Google Cloud. Используйте проект для получения доступа API к вашему аккаунту.

  • Связь между аккаунтом Merchant Center и облачным проектом Google Cloud. Создайте связь, вызвав метод Developer Registration. Этот аккаунт и эти пользователи будут использоваться для связи по вопросам интеграции API, опросов и возможностей.

  • Свяжите аккаунт Merchant Center с облачным проектом Google Cloud, зарегистрировавшись в качестве разработчика. Пользователи с ролью разработчика API будут получать сообщения об API, в том числе обязательные уведомления, опросы для разработчиков и уведомления о доступных возможностях.

Как выполнять аутентификацию для Merchant API

Для аутентификации можно использовать следующие варианты:

Идентификаторы аккаунтов и товаров

В Merchant API для идентификации используются названия ресурсов, а не идентификаторы. Пример названия ресурса для товара: accounts/123456/products/en~US~sku123, где 123456 – уникальный идентификатор аккаунта, а en~US~sku123 – уникальный идентификатор товара.

Формат URL запроса

Чтобы выполнить операцию с ресурсом, отправьте запрос на URL в следующем формате:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

Для стандартных методов, таких как list и get, часть :{METHOD} опускается.

Например, следующий запрос удаляет региональный ассортимент:

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/en~US~sku123/regionalInventories/456

Чтобы создать ресурс, используйте название родительского ресурса и следующий URL:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Например, следующий запрос показывает, как создать регион для accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Подробную информацию об отдельных сервисах можно найти в справочной документации по Merchant API.

Как начать работу с Merchant API

Чтобы быстро разобраться, как работает Merchant API, и попробовать загрузить образец товара, прочитайте статью Начало работы с Merchant API.

Используйте gRPC или REST

Merchant API поддерживает gRPC и REST. Вызовы Merchant API можно выполнять двумя способами:

gRPC (рекомендуется) REST
  1. Создайте тело запроса в виде буфера протокола.
  2. Отправьте тело запроса на сервер по протоколу HTTP/2.
  3. Десериализуйте ответ в буфер протокола.
  4. Проанализируйте полученные данные.
  1. Создайте тело запроса в виде объекта JSON.
  2. Отправьте его на сервер по протоколу HTTP 1.1.
  3. Десериализуйте ответ как объект JSON.
  4. Проанализируйте полученные данные.

Как использовать клиентские библиотеки и примеры кода

Для каждого дочернего API есть клиентские библиотеки, которые помогут вам начать работу. Примеры кода помогут вам начать писать код на Java, PHP и Python. Подробнее о примерах для Merchant API…

Справка

Подробнее о том, как получить поддержку по Merchant API…

Оставить отзыв

Чтобы оставить отзыв, отправьте одно из следующего:

  • Функции API. В разделе What is the Issue/Question? (В чем заключается проблема/вопрос?) формы обратной связи выберите вариант Send Feedback (Отправить отзыв).
  • Документация. Используйте кнопки "Нравится" и "Не нравится" на странице, а также кнопку Отправить отзыв.
  • Примеры и библиотеки. Создайте проблему в репозитории GitHub для примеров кода.

Дальнейшие действия

  • Информацию об обратной совместимости можно найти в статье Совместимость Content API for Shopping.

  • Чтобы узнать больше об основных функциях Merchant API, ознакомьтесь с руководствами в меню навигации слева.

  • Информацию о доступных ресурсах и сервисах можно найти в справочной документации.

Далее
Merchant API terms and conditions