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

원문 포스팅 🔗

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

유튜브 가이드

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

API key 발급

1. Developer Console 접속

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

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): 검색할 검색어를 지정한다.
  • 그밖의 매개변수는 공식 홈페이지 참조

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 이름이 포함되어 있다.
    • fileDetails
    • id
    • liveStreamingDetails
    • localizations
    • player
    • processingDetails
    • recordingDetails
    • snippet
    • statistics
    • status
    • suggestions
    • topicDetails
• 필터: chart(string)
  • chart 매개변수는 검색하려는 차트를 식별한다.
  • mostPopular – 지정된 콘텐츠 지역 및 동영상 카테고리에 대해 가장 인기 있는 동영상을 반환
• 선택적 매개변수
  • maxResults(integer): 결과 집합에 반환해야 하는 최대 항목 수를 지정한다. 사용 가능한 값: 0~50, 기본값은 5
  • 그밖의 매개변수는 공식 홈페이지 참조