ورق زدن فهرست منابع

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