Обзор Merchant API

Вы можете использовать Merchant API для

  • Управляйте тем, как ваш бизнес и продукция отображаются в Google.
  • Получите программный доступ к данным, аналитическим выводам и уникальным возможностям.
  • Развивайте свой бизнес и привлекайте больше клиентов в Google.

Merchant API позволяет управлять крупными и сложными учетными записями Merchant Center. Типичные сценарии использования включают следующее:

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

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

API для продавцов — это переработанная версия API контента для покупок . Он включает в себя несколько под-API .

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

Вот несколько причин перейти на API для продавцов:

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

Для выполнения запроса к API продавца необходимо следующее:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1/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/v1/accounts/123456/regions?regionId=WA HTTP/1.1

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

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

Начните использовать API для продавцов.

Чтобы быстро ознакомиться с принципами работы Merchant API и попробовать загрузить пример товара, см. раздел «Начало работы с Merchant API» .

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

API для продавцов поддерживает gRPC и REST . Вот два способа выполнения вызовов к API для продавцов:

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

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

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

Обратитесь за помощью

Для получения информации о том, как получить поддержку, см. раздел «Получение помощи по API для продавцов» .

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

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

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

Что дальше?

Назад
Latest updates
Далее
Design