Paginate query results

La consulta de Merchant Center Language proporciona la siguiente información: campos para paginación:

  • pageSize: Es la cantidad máxima de filas que se deben recuperar en una sola solicitud. La configuración predeterminada es el tamaño máximo de página de 1,000 filas.
  • pageToken: Es el token de la página que se mostrará. Si no se especifica, el primer “page”.
  • nextPageToken: Es el valor pageToken para obtener la página siguiente desde un accounts.reports.search llamada.

Cuando se proporciona un pageToken, todos los demás parámetros de la llamada deben coincidir con el llamada anterior para evitar comportamientos inesperados.

Por ejemplo, si realizas la siguiente consulta en una cuenta que tiene 100,000 offerId y pageSize se establece en 200, el resultado solo contendrá 200 Objetos ReportRow en la primera respuesta, junto con un nextPageToken:

SELECT offerId, impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2021-12-01' AND '2021-12-31'

Esta es una respuesta de muestra (los primeros cinco resultados y la nextPageToken):

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

Para recuperar las siguientes 200 filas, vuelve a enviar la solicitud con el mismo tamaño de página. pero actualiza el pageToken de la solicitud a nextPageToken desde el respuesta anterior.