با مجموعهها، منظم بمانید
ذخیره و دستهبندی محتوا براساس اولویتهای شما.
با تنظیم فیلد 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
تاریخ آخرین بهروزرسانی 2025-01-10 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-01-10 بهوقت ساعت هماهنگ جهانی."],[[["Control the maximum number of resources returned in a list request by setting the `maxResults` field, with some collections having hard limits on retrievable entries."],["Detect incomplete results by checking for a non-empty `nextPageToken` field, which indicates the presence of additional pages."],["Retrieve the next page of results by performing the same request and appending a `pageToken` field with the `nextPageToken` value from the previous page."],["The server provides new `nextPageToken` values on subsequent pages until all results are retrieved, enabling complete data retrieval through pagination."]]],[]]
