페이지 스루 리소스 목록

서버에서 반환하는 최대 리소스 수를 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