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