次の例は、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 Explorer で結果が返されません。API Explorer では動画のアップロードがサポートされていないためです。APIs Explorer の外部で独自のアプリケーションに対してこのクエリを実行できますが、API Explorer を使用して自分のアプリケーションの結果を取得することはできません。
アップロードされた各動画には、Google API Console でデベロッパーのアプリケーションに関連付けられたプロジェクト番号が自動的にタグ付けされます。
その後、検索リクエストで forDeveloper
パラメータが true に設定されると、API サービスがリクエストの認証情報を使用してデベロッパーを識別します。そのため、デベロッパーは、デベロッパー自身のアプリやウェブサイトからアップロードされた動画のみに検索結果を制限できます。他のアプリやサイトからアップロードされた動画には制限できません。
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list? part=snippet &q=fun &forDeveloper=true