다음 예는 v3 API에서 여러 유형의 검색 요청을 완료하는 방법을 보여줍니다.
동영상
이 예에서는 search.list 메서드를 호출하여 'skateboarding dog' 쿼리와 관련된 조회수가 가장 많은 고화질 (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
채널
이 예에서는 검색어 '여행'과 일치하는 채널을 찾는 방법을 보여줍니다. 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 Console에서 개발자의 애플리케이션과 연결된 프로젝트 번호가 자동으로 태그됩니다.
이후 검색 요청에서 forDeveloper 매개변수를 true로 설정하면 API 서비스는 요청의 승인 사용자 인증 정보를 사용하여 개발자를 식별합니다. 따라서 개발자는 개발자 자체 앱 또는 웹사이트를 통해 업로드된 동영상으로 결과를 제한할 수 있지만 다른 앱 또는 사이트를 통해 업로드된 동영상으로는 제한할 수 없습니다.
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true