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 gli eventi) esiste un limite rigido al numero di voci recuperate che il server non supera mai. Se il numero totale di eventi supera questo massimo, il server restituisce una pagina di risultati.
Tieni presente che maxResults non garantisce il numero di risultati in una pagina.
Un campo nextPageToken non vuoto nella risposta indica risultati incompleti.
Per recuperare la pagina successiva, ripeti la richiesta precedente e aggiungi un parametro pageToken con il valore di nextPageToken della pagina precedente. Ogni pagina successiva fornisce un nuovo nextPageToken finché la risposta non contiene tutti i risultati.
Ad esempio, la seguente query richiede la prima pagina:
GET /calendars/primary/events?maxResults=10&singleEvents=true
La risposta contiene un nextPageToken:
{
"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