Paginate query results

La requête Merchant Center Language fournit les éléments suivants : pour la pagination:

  • pageSize: nombre maximal de lignes à récupérer dans une seule requête. La taille de page maximale par défaut est de 1 000 lignes.
  • pageToken: jeton de la page à renvoyer. Si aucune valeur n'est spécifiée, la première est renvoyée.
  • nextPageToken: valeur pageToken permettant d'obtenir la page suivante à partir d'un accounts.reports.search .

Lorsqu'un pageToken est fourni, tous les autres paramètres de l'appel doivent correspondre au précédent pour éviter tout comportement inattendu.

Par exemple, si vous exécutez la requête suivante sur un compte comptant 100 000 offerId et que pageSize est défini sur 200, le résultat ne contient que 200 valeurs ReportRow dans la première réponse, ainsi qu'une nextPageToken:

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

Voici un exemple de réponse (les cinq premiers résultats et les 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"
}

Pour récupérer les 200 lignes suivantes, renvoyez la requête avec la même taille de page, Remplacez le pageToken de la requête par nextPageToken à partir de précédente.