페이지 스루 리소스 목록
maxResults 필드를 설정하여 서버가 목록 요청에 대한 응답으로 반환하는 최대 리소스 수를 제어할 수 있습니다. 또한 일부 컬렉션 (예: 이벤트)의 경우 서버가 절대 초과하지 않는 검색된 항목 수에 엄격한 제한이 있습니다. 총 이벤트 수가 이 최대값을 초과하면 서버는 결과 페이지 1개를 반환합니다.
maxResults는 페이지당 결과 수를 보장하지 않습니다.
불완전한 결과는 결과에서 nextPageToken 필드가 비어 있지 않으면 감지할 수 있습니다. 다음 페이지를 검색하려면 이전과 똑같은 요청을 실행하고 이전 페이지의 nextPageToken 값이 있는 pageToken 필드를 추가합니다. 모든 결과가 검색될 때까지 다음 페이지에 새 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
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-21(UTC)
[null,null,["최종 업데이트: 2024-12-21(UTC)"],[[["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."]]],[]]
