[Open API] Youtube - 유튜브 검색 API 포스트맨으로 요청하여 응답받기 테스트 (YouTube Data API v3)

유튜브 검색 API를 사용하면 좀더 다양한 서비스를 만들 수 있다.
포스트맨을 활용해서 유튜브 검색 API을 테스트 해보자.

1. API 키 얻기

먼저 Google Cloud Platform에서 프로젝트를 생성하고 유튜브 Data API를 활성화하고 API 키를 얻어야 한다.
API 키는 API 요청을 보낼 때 인증을 위해 필요한다.

https://console.cloud.google.com/

Google 클라우드 플랫폼

 

- 프로젝트를 생성하기

 

- 프로젝트 선택 후 API 및 서비스 - 라이브러리

 

- youtube 검색하여 YouTube Data API v3 선택

 

- API 사용해보기 클릭하여 아래 래퍼런스 확인.

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

API Reference  |  YouTube Data API  |  Google for Developers

 

2. 포스트맨 설치

포스트맨은 API 개발 및 테스트를 위한 도구로 사용자 친화적인 인터페이스를 통해 HTTP 요청을 만들고 테스트할 수 있으며, 다양한 환경에서의 API 작업을 간편하게 수행할 수 있다. 또한, 컬렉션과 환경을 통해 요청을 구성하고 관리할 수 있어 팀 작업에도 유용해서 많이 추천하고 사용한다.

아래에서 다운받아서 회원가입 후 데스크탑용을 설치한다.(방법은 생략)

https://www.postman.com/downloads/

Download Postman | Get Started for Free

 

3. 요청 설정

- HTTP 메소드는 유튜브 검색 API는 GET 메소드를 사용하고
- 요청 URL은 유튜브 검색 API의 엔드포인트인 " https://www.googleapis.com/youtube/v3/search "을 사용한다.
- 그 다음 Params에 쿼리의 key와 value를 작성하는데 필수 파라미터는 key와 q(검색어) 이다.
- 위에 설정이 다 되었으면 q= 뒤에 검색어를 넣어 "Send"를 클릭한다.

 

[필수 파라미터]

• q (검색어): 검색할 키워드나 문구를 지정한다. 이 파라미터는 필수이며, API를 통해 검색할 내용을 정의한다.
• key (API 키): API 키는 Google Cloud Platform에서 생성한 키를 사용하여 인증을 처리한다. 이 파라미터 또한 필수로 제공되어야 한다.

[선택 파라미터]

• part: 응답으로 받고자 하는 리소스의 부분을 지정한다. 예를 들어, "snippet", "id", "contentDetails" 등을 지정할 수 있다. 기본값은 "snippet"이다.
• maxResults: 한 페이지에 표시할 검색 결과의 최대 개수를 지정한다. 기본값은 5이며, 최대 50까지 지정할 수 있다.
• type: 검색 결과로 받고자 하는 유형을 지정다. 예를 들어, "video", "channel", "playlist" 등이 있다.
• order: 검색 결과의 정렬 순서를 지정다. "date", "rating", "relevance", "title", "videoCount" 등을 사용할 수 있다.
• regionCode: 검색을 수행할 지역의 코드를 지정다. 이를 사용하여 특정 지역에서의 인기 있는 동영상을 검색할 수 있다.
• videoDuration: 동영상의 길이를 지정하여 검색 결과를 필터링할 수 있다. "any", "long", "medium", "short" 등을 사용할 수 있다.
• publishedAfter / publishedBefore: 검색 결과로 받고자 하는 동영상의 출시일을 지정한다.

3. 응답 확인

유튜브 검색 API로부터의 요청이 성공적이면 응답을 확인한다.
이 응답에는 검색 결과와 관련된 정보가 포함되어 JSON 데이터 형식으로 보여준다.

}