Отправьте несколько запросов одновременно

Вы можете использовать пакетные запросы с API Merchant для отправки нескольких HTTP-запросов за один вызов API.

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

Пакетный запрос — это один стандартный HTTP-запрос, содержащий несколько вызовов API, использующих тип содержимого multipart/mixed . В основном HTTP-запросе каждая часть содержит вложенный HTTP-запрос.

Вы можете отправить пакетный запрос на указанный batchPath для API. batchPath для Merchant API beta — batch/{sub-api}/v1beta . Вы можете найти batchPath для других API в их discovery documents . Примеры причин пакетирования ваших запросов включают:

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

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

Написать пакетный запрос

Вот пример пакетного запроса Merchant API. Этот запрос объединяет запрос get для получения регионального инвентаря для продукта и запрос insert для обновления регионального инвентаря для того же продукта. Вам следует точно следовать формату примера:

  1. Используйте https://merchantapi.googleapis.com/batch/{sub-api}/v1beta в качестве базового URL.
  2. Укажите границу для разделения каждого вложенного запроса, например: -H 'Content-Type: multipart/mixed,boundary=batch_inventory' \
  3. Разделяйте каждый вложенный запрос границей, например --batch_inventory .
  4. Включите Content-Type: application/http в начало каждого вложенного запроса.
  5. Используйте Content-ID , чтобы пометить каждый вложенный запрос собственным ID. Например: Content-ID: <get:online:en:US:123456> .
  6. Включайте пустую строку между заголовком, путем и телом каждого вложенного запроса. Если у вложенного запроса нет тела, оставьте пустую строку перед следующей границей.
  7. Не включайте базовый URL в каждый отдельный вложенный запрос.
  8. Завершите основной запрос конечной границей, например --batch_inventory– . 
curl https://merchantapi.googleapis.com/batch/inventories/v1beta \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Content-Type: multipart/mixed,boundary=batch_inventory' \
--data '
--batch_inventory
Content-Type: application/http
Content-ID: <get:online:en:US:123456>
GET /inventories/v1beta/accounts/123/products/online:en:US:123456/regionalInventories
--batch_inventory
Content-Type: application/http
Content-ID: <post:online:en:US:123456>
POST /inventories/v1beta/accounts/123/products/online:en:US:123456/regionalInventories:insert
{
   "region: "123456",
    "price": {
        "amountMicros": "100000000",
        "currencyCode": "USD"
    }
}
--batch_inventory--
'

Примечания по заказу

  • Запросы могут выполняться не в том порядке, в котором вы их указали.
  • Используйте Content-ID для идентификации отдельных запросов.
  • Если вам необходимо выполнить вызовы в определенном порядке, отправляйте их по отдельности и дождитесь ответа на первый запрос, прежде чем отправлять следующий.

Прочитать пакетный ответ

Вот пример ответа HTTP-пакета. Порядок ответов может не совпадать с порядком запросов. Используйте Content-ID для идентификации вложенного запроса, к которому принадлежит каждый вложенный ответ. В ответах API добавляет префикс response- к каждому Content-ID .

--batch_inventory
Content-Type: application/http
Content-ID: <response-get:online:en:US:123456>
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer
{}
--batch_inventory
Content-Type: application/http
Content-ID: <response-post:online:en:US:123456>
HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Vary: Origin
Vary: X-Origin
Vary: Referer
{
  "name": "accounts/123/products/online:en:US:123456/regionalInventories/123456",
  "region": "123456",
  "price": {
    "amountMicros": "100000000",
    "currencyCode": "USD"
  }
}
--batch_inventory--
'