Scorri elenchi di risorse

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 massimo al numero di voci recuperate che il server non supererà mai. Se il numero totale di eventi supera questo valore massimo, il server restituisce una pagina di risultati.

Tieni presente 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 esatta eseguita in precedenza e aggiungi un campo pageToken con il valore di nextPageToken della pagina precedente. Nelle pagine successive viene fornito un nuovo nextPageToken finché non vengono recuperati tutti i risultati.

Ad esempio, di seguito è riportata una query seguita dalla query per recuperare la pagina successiva dei risultati in un elenco paginato:

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