[Youtube API] YouTube Data API v3 개요

베하~!! 안녕하세요 1-Tier 팀 입니다!! 

이번에는 제가 개인적으로 API 호출 및 응용을 통한 학습을 위해 하고있는 개발 프로젝트를 함께 공유하면서 여러 기술이나 방법론 등을 공유하고 소개할까 합니다.

제가 사용할 API는 YouTube Data API v3 입니다!

 

YouTube Data API v3는 Youtube와 상호작용할 수 있는 애플리케이션을 개발할 수 있도록 해주는 API로 여러 리소스를 통해 원하는 기능을 개발할 수 있습니다.

저는 해당 API를 이용하여 VOC개발을 목표로 하여 특정 제품이나 검색어에 대한 영상의 좋아요, 조회수 등을 기준으로 순위를 매기고 일정 순위까지의 영상의 댓글을 추출하여 ChatGPT 모델을 사용해 크게 긍정과 부정으로 나누어 VOC를 구현할 계획입니다. (과연 계획대로 될지...)

 

그럼 YouTube Data API v3의 리소스 유형부터 알아보겠습니다.

리소스 유형

activity	특정 사용자가 YouTube 사이트에서 실행한 작업의 정보를 포함합니다. 동영상 평가, 동영상 공유, 동영상을 즐겨찾기에 추가, 채널 게시판에 게시 등이 포함됩니다.
channel	단일 YouTube 채널에 대한 정보를 포함합니다.
channelBanner	새로 업로드한 이미지를 채널의 배너 이미지로 설정하는 데 사용할 URL을 식별합니다.
guideCategory	YouTube가 채널의 콘텐츠 또는 기타 지표(예: 인기도)를 기반으로 채널에 연결하는 카테고리를 식별합니다.
playlist	단일 YouTube 재생목록을 표시합니다. 재생목록은 순서대로 감상하거나 다른 사용자와 공유할 수 있는 동영상의 모음입니다.
playlistItem	재생목록에 포함된 동영상과 같은 리소스를 식별합니다. playlistItem 리소스에는 포함된 리소스가 재생목록에서 사용되는 방식을 설명하는 세부정보도 포함되어 있습니다.
search result	검색 매개변수와 일치하는 YouTube 동영상, 채널 또는 재생목록의 정보를 포함합니다. 검색 결과는 동영상과 같이 고유하게 식별할 수 있는 리소스를 보여주지만, 자체적으로는 영구적인 데이터를 가지지 않습니다.
subscription	YouTube 사용자의 구독 정보를 포함합니다. 구독정보는 채널에 새 동영상이 추가되거나 다른 사용자가 YouTube에서 동영상 업로드, 동영상 평가 또는 동영상 추천 등의 작업을 수행할 때 이를 알려줍니다.
thumbnail	하나의 리소스에 연결된 미리보기 이미지를 식별합니다.
video	단일 YouTube 동영상을 표시합니다.
videoCategory	업로드된 동영상과 연결되었거나 연결할 수 있는 카테고리를 식별합니다.

위 리소스로 할 수 있는 작업은 다음과 같습니다.

지원되는 작업

list	0개 이상의 리소스 목록을 검색(GET)합니다.
insert	새 리소스를 만듭니다(POST).
update	요청에 포함된 데이터를 반영하도록 기존 리소스를 수정(PUT)합니다.
delete	특정 리소스를 삭제(DELETE)합니다.

YouTube Data API v3으로 다양한 서비스를 만들 수 있는데, 중요한 것은 할당량이 있기 때문에 대용량, 다량의 트래픽을 요구하는 서비스는 구현하기 힘들어서 서비스의 규모와 제공 범위를 잘 정해서 구현해야 합니다.

 

* 동영상 1건을 검색하면 할당량 1이 차감되는 것이 아닌 해당 동영상의 모든 리소스를 호출하기 때문에 실질적으로 할당량의 80%정도 사용 가능합니다.

할당량

YouTube Data API v3는 서비스 품질을 위해 할당량을 제한합니다.

• 각 반환된 리소스의 ID만 검색하는 간단한 읽기 작업의 비용은 약 1단위입니다.
• 쓰기 작업의 비용은 약 50단위입니다.
• 동영상 업로드의 비용은 약 1600단위입니다.

제한하는 할당량은 다음과 같습니다.

Queries per day : 10,000
Queries per minute : 1,800,000
Queries per minute per user : 180,000

 

다음 포스팅에서는 API로 사용자에게 검색어를 받아 해당 유튜브 동영상을 검색한 결과를 출력해 보도록 하겠습니다!

베빠~!!