구현: 페이지로 나누기

다음 예는 YouTube Data API (v3) 쿼리에 대한 결과 세트를 추가로 검색하는 방법을 보여줍니다.

API는 maxResults 매개변수를 사용하여 API 응답에 포함해야 하는 항목 수를 나타냅니다. 거의 모든 API의 list 메서드 (videos.list, playlists.list 등)가 이 매개변수를 지원합니다.

쿼리에 추가 결과를 사용할 수 있는 경우 API 응답에 nextPageToken 속성, prevPageToken 속성 또는 둘 다 포함됩니다. 그런 다음 이러한 속성 값을 사용하여 pageToken 매개변수를 설정하여 결과 페이지를 추가로 가져올 수 있습니다.

예를 들어 다음 쿼리는 '스케이트보딩 강아지' 검색어와 일치하는 조회수가 가장 높은 동영상 10개의 검색 결과를 가져옵니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &q=skateboarding+dog
        &type=video

API 응답에는 검색어의 첫 번째 10개 일치 항목과 다음 10개 결과를 검색하는 데 사용할 수 있는 nextPageToken 속성이 포함됩니다.

아래 쿼리는 쿼리의 다음 10개 결과를 검색합니다.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &maxResults=10
        &order=viewCount
        &pageToken=CAoQAA
        &q=skateboarding+dog
        &type=video

참고: API 탐색기에서 이 요청을 완료하려면 pageToken 매개변수의 값을 업데이트해야 할 수 있습니다. 첫 10개의 결과를 검색하는 쿼리를 실행하여 올바른 pageToken 매개변수 값을 가져옵니다.