Puoi controllare il numero massimo di risorse che il server restituisce nella risposta a una richiesta di elenco impostando il campo maxResults. Inoltre, per alcune raccolte (ad esempio 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 in 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 della pagina precedente. Verrà fornito un nuovo nextPageToken nelle pagine seguenti finché non saranno 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 recupera il valore da nextPageToken e
lo invia come valore per pageToken:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA