Puoi controllare il numero massimo di risorse restituite dal server nella
risposta a una richiesta di elenco impostando il campo maxResults. Inoltre,
per alcune raccolte (ad esempio Eventi) esiste un limite rigido al numero di
voci recuperate che il server non supererà mai. Se il numero totale di eventi supera questo massimo, il server restituisce una pagina di risultati.
Ricorda che maxResults non garantisce il numero di risultati su una pagina.
I risultati incompleti possono essere rilevati da un campo nextPageToken non vuoto nel risultato. Per recuperare la pagina successiva, esegui esattamente la stessa richiesta
di prima e aggiungi un campo pageToken con il valore di
nextPageToken della pagina precedente. Un nuovo nextPageToken viene fornito
nelle pagine seguenti finché non vengono recuperati tutti i risultati.
Ad esempio, ecco una query seguita dalla query per recuperare la pagina successiva dei risultati in un elenco impaginato:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
La query successiva prende il valore da nextPageToken e
lo invia come valore per pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA