다음 예는 v3 API에서 여러 유형의 검색 요청을 완료하는 방법을 보여줍니다.
동영상
이 예에서는 search.list 메서드를 호출하여 '스케이트보딩 개'라는 검색어와 연결된 가장 조회수가 높은 고화질 (HD) 동영상을 찾습니다. 이 쿼리는 order, part, q, type, videoDefinition 매개변수를 설정합니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &order=viewCount &q=skateboarding+dog &type=video &videoDefinition=high
코드 샘플은 search.list 메서드 문서를 참고하세요.
재생목록
이 예는 'GoogleDevelopers'라는 검색어와 일치하는 재생목록을 찾는 방법을 보여줍니다. search.list 메서드를 호출하고 결과 세트의 재생목록만 포함하도록 type 매개변수의 값을 playlist로 설정합니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=GoogleDevelopers &type=playlist
채널
이 예에서는 검색어 'travel'과 일치하는 채널을 찾는 방법을 보여줍니다. search.list 메서드를 호출하고 type 매개변수의 값을 channel로 설정하여 결과 세트에 채널만 포함되도록 합니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=travel &type=channel
특정 언어 관련 검색결과
이 예에서는 search.list 메서드를 호출하여 특정 언어와 가장 관련성 높은 검색결과를 찾습니다. 이 예에서는 검색어가 marine (q=marine)이고 API 응답에 프랑스어 (relevanceLanguage=fr)와 가장 관련성이 높은 결과가 포함되어야 함을 보여줍니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=marine &relevanceLanguage=fr
요청에서는 type 매개변수의 값을 설정하지 않습니다. 즉, 각 검색결과에서 동영상, 재생목록 또는 채널을 참조할 수 있습니다.
개발자의 앱 또는 웹사이트를 통해 업로드된 동영상
이 예에서는 forDeveloper 매개변수를 사용하여 개발자의 애플리케이션 또는 웹사이트를 통해 업로드된 동영상만 검색하도록 제한하는 방법을 보여줍니다. 이 매개변수는 q 매개변수와 같은 선택적 검색 매개변수와 함께 사용할 수 있습니다.
참고: 이 쿼리는 API 탐색기에서 동영상 업로드를 지원하지 않으므로 실제로 API 탐색기에서 결과를 반환하지 않습니다. API 탐색기 외부에서 자신의 애플리케이션에 대해 이 쿼리를 실행할 수는 있지만 API 탐색기를 사용하여 여러분의 애플리케이션에 대한 결과를 가져올 수는 없습니다.
업로드된 각 동영상에는 Google API 콘솔에서 개발자의 애플리케이션과 연결된 프로젝트 번호가 자동으로 태그됩니다.
이후 검색 요청에서 forDeveloper 매개변수를 true로 설정하면 API 서비스가 요청의 승인 사용자 인증 정보를 사용하여 개발자를 식별합니다. 따라서 개발자는 다른 개발자의 사이트나 앱을 통해 업로드된 동영상으로 검색결과를 제한할 수 있지만, 다른 앱이나 사이트를 통해 업로드된 동영상으로 제한할 수는 없습니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true