[Swift] Youtube API 활용하여 앱 만들기 (1) : Youtube API 사용방법

Youtube API 사용 방법에 대해 정리해보려고 한다.

 

유튜브 가이드

https://developers.google.com/youtube/v3/docs?hl=ko 

API Reference  |  YouTube Data API  |  Google for Developers

 

API key 발급

1. Developer Console 접속

https://console.developers.google.com/?hl=ko

Google 클라우드 플랫폼

 

2. 라이브러리 - YouTube Data API v3 선택

 

3. API key 생성

 

API 사용

1. 검색

요청: HTTP 요청

GET https://www.googleapis.com/youtube/v3/search

• 필수 매개변수: part(string)
  part 매개변수는 API 응답이 포함하는 search 리소스 속성 하나 이상의 쉼표로 구분된 목록을 지정한다. (snippet로 설정)
• 선택적 매개변수
  • maxResults(integer)
    : 결과 집합에 반환해야 하는 최대 항목 수를 지정한다. 사용 가능한 값: 0~50, 기본값은 5
  • q(string)
    : 검색할 검색어를 지정한다.
  • 그밖의 매개변수는 공식 홈페이지 참조

Search: list  |  YouTube Data API  |  Google for Developers

 

 

2. 동영상

요청: HTTP 요청

GET https://www.googleapis.com/youtube/v3/videos

• 필수 매개변수: part(string)
  part 매개변수는 API 응답이 포함하는 video 리소스 속성 하나 이상의 쉼표로 구분된 목록을 지정한다.
  매개변수가 하위 속성을 포함하는 속성을 식별하는 경우 하위 속성이 응답에 포함된다. 예를 들어 video 리소스에서 snippet 속성에는 channelId, title, description, tags, categoryId 속성이 포함되어 있다. 따라서 part=snippet를 설정하면 API 응답에 이러한 모든 속성이 포함된다.
  다음 목록에는 매개변수 값에 포함할 수 있는 part 이름이 포함되어 있습니다.
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
• 필터: chart(string)
  chart 매개변수는 검색하려는 차트를 식별한다.
  • mostPopular – 지정된 콘텐츠 지역 및 동영상 카테고리에 대해 가장 인기 있는 동영상을 반환
• 선택적 매개변수
  • maxResults(integer)
    : 결과 집합에 반환해야 하는 최대 항목 수를 지정한다. 사용 가능한 값: 0~50, 기본값은 5
  • 그밖의 매개변수는 공식 홈페이지 참조

Videos: list  |  YouTube Data API  |  Google for Developers