次の例は、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 に結果は返されません。このクエリは、API 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