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