Impagina i risultati della query

Per gestire set di risultati contenenti un numero elevato di righe, Merchant Center Center Query Language supporta l'impaginazione. Sono disponibili due parametri controlla l'impaginazione nella richiesta reports.search corpo del testo: page_size e page_token, oltre a un campo di output nella risposta del testo: next_page_token.

Il parametro page_size specifica il numero massimo di righe da recuperare in un una singola richiesta. Se non specificato, viene impostato automaticamente la dimensione massima della pagina di 1000 righe.

Il parametro page_token specifica il token della pagina da restituire. Se non specificato, viene restituita la prima pagina. Per recuperare una pagina successiva, valore ricevuto come next_page_token dalla precedente chiamata reports.search deve essere fornito come page_token. Quando viene fornito un valore page_token, tutte le altre nella chiamata devono corrispondere alla chiamata precedente che ha restituito page_token per evitare comportamenti imprevisti.

Esempio:

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

Per questa query, supponiamo che l'account contenga 100.000 offer_ids e Il valore page_size è impostato su 200. Il set di risultati conterrà 200 ReportRow nella prima risposta, insieme a un next_page_token.

Per recuperare le successive 200 righe, invia di nuovo la richiesta con le stesse dimensioni di pagina, ma aggiorna il valore page_token della richiesta con i valori della risposta precedente next_page_token.

Ecco un esempio di corpo della risposta (i primi cinque risultati più il 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"
}