Para controlar conjuntos de resultados que contengan una gran cantidad de filas, el lenguaje de consultas de Merchant Center admite la paginación. Hay dos parámetros disponibles para controlar la paginación en el cuerpo de la solicitud reports.search: page_size y page_token, además de un campo de salida en el cuerpo de la respuesta: next_page_token.
El parámetro page_size especifica la cantidad máxima de filas que se recuperarán en una sola solicitud. Si no se especifica, se establece de forma automática en el tamaño de página máximo de 1,000 filas.
El parámetro page_token especifica el token de la página que se mostrará. Si no se especifica, se muestra la primera página. Para recuperar una página posterior, el valor recibido como next_page_token de la llamada reports.search anterior se debe proporcionar como page_token. Cuando se proporciona un page_token, todos los demás parámetros de la llamada deben coincidir con la llamada anterior que mostró el page_token para evitar un comportamiento inesperado.
Ejemplo:
SELECT
segments.offer_id,
metrics.impressions,
metrics.clicks,
metrics.ctr
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2021-12-01' AND '2021-12-31'
Para esta consulta, supongamos que la cuenta contiene 100,000 offer_ids y el page_size está configurado en 200. El conjunto de resultados contendrá 200 objetos ReportRow en la primera respuesta, junto con un next_page_token.
Para recuperar las 200 filas siguientes, vuelve a enviar la solicitud con el mismo tamaño de página, pero actualiza el page_token de la solicitud al next_page_token de la respuesta anterior.
A continuación, se muestra un ejemplo de cuerpo de respuesta (los primeros cinco resultados más 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"
}