Начните работу с Merchant API

Чтобы начать работу, включите Merchant API в своем облачном проекте .

Вот как использовать Merchant API:

Используйте клиентские библиотеки

Merchant API состоит из нескольких суб-API .

Каждый суб-API содержит примеры кода и клиентские библиотеки , которые помогут вам начать работу.

Если вы уже используете Content API для покупок, см. раздел Совместимость Content API для покупок .

Отправлять запросы

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

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

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

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

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

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

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

Например, вот как вы создаете новый регион для account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

Дополнительную информацию о конкретных услугах см. в справочной документации 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. Интерпретируйте результаты.

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

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

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

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

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

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