صفحه از طریق فهرست منابع

با تنظیم فیلد 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