brunch

브런치북 유튜브 API 개발 이야기 15화

라이킷 1 댓글

You can make anything
by writing

C.S.Lewis

계정을 잊어버리셨나요?

by 핑크곰 Feb 21. 2020

유튜브 API — 8.페이징

본글에서는 7.Data API(재생목록 편)에서 잠시 언급했던 페이징 처리에 대해 살펴 보자.

API 살펴보기편에서도 언급했지만, 유튜브 API를 사용할 때는 쿼터(할당량)에 대한 고려가 반드시 필요하다. GCP에 등록된 프로젝트 쿼터를 다 소비한 경우, API를 이용하는 시스템에는 에러 메세지만 넘처 날게다. 특히, 주기적으로 콘텐츠 정보 수집하는 서비스에서 쿼터 문제로 수집이 안된거라면 추후 데이터를 맞추기 위해서 엄청난 노력이 필요하다.(생각만 해도, 끔찍하다 -_ -;)

물론 API를 제공해주는 입장에서는 안정적인 서버 운영을 위해서 이런 제약사항이 필요할 수 밖에 없다. 때문에 효율적인 쿼터 사용을 위한 노력이 필요하며, 본 글에서 다루는 페이징 처리가 그 방법 중 하나라고 볼 수 있다.

아래는 지난번에 살펴봤던 재생목록에 들어있는 영상목록 조회 결과다.

뽕포유 재생목록에 들어있는 영상 목록

뽕포유 재생목록에 들어있는 영상의 수는 68건. 그런데 그 아래에 보면 페이지당 결과가 50건으로 되어있다. 소스 코드에서 maxResults를 50으로 설정했기 때문에 한 번에 불러올 수 있는 최대 영상정보는 50건이다.

maxResults 속성은 한번에 불러올 수 있는 건수를 의미하며 최대 50까지 설정이 가능하다. 때문에 지금처럼 50건을 넘어가는 경우에는 나머지 영상 정보를 조회하기 위해 페이징 토큰 방식을 사용한다.

현재 조회한 이후의 데이터(18건)를 조회할 때는 조회 필드에 추가한 nextPageToken의 값을 pageToken 속성의 값으로 추가하면 결과를 받아올 수 있다.

위의 결과에 있던 nextPageToken의 값인 'CDIQAA'을 pageToken 속성의 값으로 설정했다.

async function getPlaylistItemData(oauth2Client, playlistId) {
  const res = await service.playlistItems.list({
    auth: oauth2Client,
    part: 'snippet',
    fields: 'prevPageToken, nextPageToken, pageInfo, items(id, snippet(title, description, publishedAt, thumbnails(default(url))))',
    maxResults: 50,
    playlistId: playlistId,
    pageToken: 'CDIQAA'
  }); if (res.data.items == null || res.data.items.length === 0) {
    throw new Error("데이터가 존재하지 않습니다.");
  } return res.data;
}