Разбивка результатов запроса на страницы

Для обработки наборов результатов, содержащих большое количество строк, язык запросов Merchant Center поддерживает пагинацию. Для управления пагинацией в теле запроса reports.search доступны два параметра: page_size и page_token , а также одно выходное поле в теле ответа : next_page_token .

Параметр page_size определяет максимальное количество строк, извлекаемых за один запрос. Если параметр не указан, автоматически устанавливается максимальный размер страницы — 1000 строк.

Параметр page_token задаёт токен возвращаемой страницы. Если он не указан, возвращается первая страница. Для получения последующей страницы значение, полученное как next_page_token из предыдущего вызова reports.search , должно быть передано в качестве page_token . Если указан page_token , все остальные параметры вызова должны соответствовать предыдущему вызову, вернувшему page_token чтобы избежать непредвиденного поведения.

Пример:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2021-12-01' AND '2021-12-31'

Для этого запроса предположим, что учетная запись содержит 100 000 offer_ids , а page_size установлен на 200. Тогда набор результатов будет содержать 200 объектов ReportRow в первом ответе вместе с next_page_token .

Чтобы получить следующие 200 строк, отправьте запрос еще раз с тем же размером страницы, но обновите page_token запроса до next_page_token предыдущего ответа.

Вот пример текста ответа (первые пять результатов плюс next_page_token ):

{
  "results": [
    {
      "segments": {
        "offerId": "12345"
      },
      "metrics": {
        "clicks": "0",
        "impressions": "59",
        "ctr": 0
      }
    },
    {
      "segments": {
        "offerId": "12346"
      },
      "metrics": {
        "clicks": "9625",
        "impressions": "276695",
        "ctr": 0.034785594246372356
      }
    },
    {
      "segments": {
        "offerId": "12347"
      },
      "metrics": {
        "clicks": "148",
        "impressions": "22045",
        "ctr": 0.0067135404853708325
      }
    },
    {
      "segments": {
        "offerId": "12348"
      },
      "metrics": {
        "clicks": "11",
        "impressions": "1100",
        "ctr": 0.01
      }
    },
    {
      "segments": {
        "offerId": "12349"
      },
      "metrics": {
        "clicks": "569",
        "impressions": "62977",
        "ctr": 0.0090350445400701838
      }
    },
    ...
  ],
  "nextPageToken": "CMgB"
}