Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
maxResults alanını ayarlayarak sunucunun bir liste isteğine yanıt olarak döndürdüğü maksimum kaynak sayısını kontrol edebilirsiniz. Ayrıca, bazı koleksiyonlar (ör. Etkinlikler) için sunucunun hiçbir zaman aşmayacağı, alınan girişlerin sayısı konusunda kesin bir sınır vardır. Toplam etkinlik sayısı bu maksimum değeri aşarsa sunucu bir sayfalık sonuç döndürür.
maxResults işaretinin, bir sayfadaki sonuç sayısını garanti etmediğini unutmayın.
Eksik sonuçlar, sonuçtaki boş olmayan bir nextPageToken alanı ile tespit edilebilir. Bir sonraki sayfayı almak için daha önce yaptığınız isteğin aynısını yapın ve önceki sayfadaki pageToken alanına nextPageToken değerini ekleyin. Tüm sonuçlar alınana kadar aşağıdaki sayfalarda yeni bir nextPageToken sağlanır.
Örneğin, burada bir sorgu ve ardından sayfalandırılmış listedeki sonuçların bir sonraki sayfasını almak için kullanılan sorgu yer almaktadır:
GET /calendars/primary/events?maxResults=10&singleEvents=true
//Result contains
"nextPageToken":"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA",
Sonraki sorgu, nextPageToken değerini alır ve pageToken değeri olarak gönderir:
GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Page through lists of resources\n\nYou can control the maximum number of resources the server returns in the\nresponse to a list request by setting the `maxResults` field. Furthermore,\nfor some collections (such as Events) there is a hard limit on the number of\nretrieved entries that the server will never exceed. If the total number of\nevents exceeds this maximum, the server returns one page of results.\n\nRemember that `maxResults` does not guarantee the number of results on one page.\nIncomplete results can be detected by a non-empty `nextPageToken` field in\nthe result. In order to retrieve the next page, perform the exact same request\nas previously and append a `pageToken` field with the value of\n`nextPageToken` from the previous page. A new `nextPageToken` is provided\non the following pages until all the results are retrieved.\n\nFor example, here is a query followed by the query for retrieving the\nnext page of results in a paginated list: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true\n\n //Result contains\n\n \"nextPageToken\":\"CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA\",\n\nThe subsequent query takes the value from `nextPageToken` and\nsubmits it as the value for `pageToken`: \n\n GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"]]