Обзор Merchant API

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

Вы можете использовать Merchant API, чтобы привлечь больше клиентов и продемонстрировать свои продукты в Google. Вы можете использовать Merchant API для управления большими или сложными аккаунтами Merchant Center. Некоторые типичные случаи использования включают следующее:

  • Автоматизированное управление аккаунтом
  • Автоматизированное управление продуктами
  • Автоматизированное управление запасами
  • Пользовательские отчеты

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

Merchant API — это обновленная версия Content API для покупок , состоящая из нескольких суб-API .

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

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

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

  • Улучшение управления данными о запасах за счет внедрения следующих новых методов:

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

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

  • Представляет accounts.autofeedSettings и методы для получения и обновления настроек автоподачи.

  • Добавлена ​​возможность загрузки обзоров продуктов и обзоров продавцов .

  • Упрощен accounts.products с добавлением accounts.productInputs .

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

  • Новая таблица NonProductPerformanceView для данных о производительности, не связанных с продуктом, например информации о входящем трафике на веб-сайт розничного продавца.

  • Модульная конструкция с отдельными и более частыми улучшениями функций.

  • Улучшено соответствие предложениям Google по улучшению API .

  • Обновлена ​​документация и примеры кода .

Дополнительную информацию см. в разделе Новые функции, представленные в бета-версии Merchant API .

Прежде чем начать

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

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

  • Проект Google Cloud: проект используется для получения доступа API к вашей учетной записи.

Аутентификация с помощью Merchant API

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

  • Вы можете создать идентификатор и секрет клиента OAuth 2.0 для своего приложения. Затем идентификатор и секрет можно использовать для создания учетных данных OAuth 2.0, необходимых для вызовов API к учетной записи Merchant Center.
  • Вы можете создать учетную запись службы и загрузить ее закрытый ключ для выполнения вызовов API.

Идентификаторы учетной записи и продукта

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

Формат URL-адреса запроса

Для работы с ресурсом отправляйте запросы на URL-адреса в следующем формате:

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~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/v1beta/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 (рекомендуется) ОТДЫХ
  1. Создайте тело запроса как буфер протокола.
  2. Отправьте тело запроса на сервер через HTTP/2.
  3. Десериализовать ответ в буфер протокола.
  4. Интерпретируйте результаты.
  1. Создайте тело запроса как объект JSON.
  2. Отправьте его на сервер, используя HTTP 1.1.
  3. Десериализуйте ответ как объект JSON.
  4. Интерпретируйте результаты.

Используйте клиентские библиотеки и примеры кода.

Каждый суб-API имеет клиентские библиотеки , которые помогут вам начать работу. Примеры кода помогут вам начать писать код на Java, PHP и Python. Дополнительную информацию см. в разделе «Примеры для Merchant API» .

Получить помощь

Информацию о получении поддержки см. в разделе «Помощь по Merchant API» .

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

Период бета-тестирования дает нам возможность собрать и обработать ваши отзывы до выпуска общедоступной версии. Чтобы оставить отзыв, отправьте одно из следующих сообщений:

  • Возможности API: Отправьте форму обратной связи.
  • Документация: используйте встроенные рейтинги и кнопку «Отправить отзыв» .
  • Образцы и библиотеки: создайте задачу в репозитории GitHub для примеров кода.

Для предоставления общей обратной связи после реализации каждой задачи воспользуйтесь формой обратной связи .

Что дальше

Далее
Дизайн