شما میتوانید با تنظیم فیلد maxResults حداکثر تعداد منابعی را که سرور در پاسخ به یک درخواست لیست برمیگرداند، کنترل کنید. علاوه بر این، برای برخی از مجموعهها (مانند رویدادها) محدودیت سختی در تعداد ورودیهای بازیابی شده وجود دارد که سرور هرگز از آن تجاوز نمیکند. اگر تعداد کل رویدادها از این حداکثر بیشتر شود، سرور یک صفحه از نتایج را برمیگرداند.
به یاد داشته باشید که maxResults تعداد نتایج در یک صفحه را تضمین نمیکند. یک فیلد nextPageToken غیر خالی در پاسخ، نتایج ناقص را نشان میدهد. برای بازیابی صفحه بعدی، درخواست قبلی را تکرار کنید و یک پارامتر pageToken با مقدار nextPageToken از صفحه قبل اضافه کنید. هر صفحه بعدی یک nextPageToken جدید ارائه میدهد تا زمانی که پاسخ شامل تمام نتایج باشد.
برای مثال، کوئری زیر صفحه اول را درخواست میکند:
GET /calendars/primary/events?maxResults=10&singleEvents=true
پاسخ شامل یک nextPageToken است:
{
"nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}
کوئری بعدی مقدار را از nextPageToken میگیرد و آن را به عنوان مقدار برای pageToken ارسال میکند:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA