페이지 스루 리소스 목록

maxResults 필드를 설정하여 목록 요청에 대한 응답에서 서버가 반환하는 리소스의 최대 수를 제어할 수 있습니다. 또한 일부 컬렉션 (예: 이벤트)의 경우 서버가 절대 초과하지 않는 검색된 항목 수에 엄격한 제한이 있습니다. 총 이벤트 수가 이 최댓값을 초과하면 서버는 결과의 한 페이지를 반환합니다.

maxResults는 한 페이지의 결과 수를 보장하지 않습니다. 응답에 비어 있지 않은 nextPageToken 필드가 있으면 결과가 불완전함을 나타냅니다. 다음 페이지를 검색하려면 이전 요청을 반복하고 이전 페이지의 nextPageToken 값을 사용하여 pageToken 매개변수를 추가합니다. 각 후속 페이지는 응답에 모든 결과가 포함될 때까지 새 nextPageToken을 제공합니다.

예를 들어 다음 쿼리는 첫 번째 페이지를 요청합니다.

GET /calendars/primary/events?maxResults=10&singleEvents=true

응답에 nextPageToken이 포함됩니다.

{
  "nextPageToken": "CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA"
}

후속 쿼리는 nextPageToken에서 값을 가져와 pageToken의 값으로 제출합니다.

GET /calendars/primary/events?maxResults=10&singleEvents=true&pageToken=CiAKGjBpNDd2Nmp2Zml2cXRwYjBpOXA