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 (come gli eventi), esiste un limite fisso al numero di voci recuperate che il server non supererà mai. Se il numero totale di
eventi supera questo limite 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 la stessa richiesta
di prima e aggiungi un campo pageToken
con il valore
nextPageToken
dalla pagina precedente. Un nuovo nextPageToken
viene fornito
nelle pagine seguenti fino a quando non verranno 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