実装: 検索リクエスト

次の例は、v3 API でさまざまなタイプの検索リクエストを完了する方法を示しています。

動画

この例では、search.list メソッドを呼び出して、クエリ「スケートボード ドッグ」に関連する視聴回数の多い高画質(HD)動画を検索します。このクエリは、orderpartqtypevideoDefinition パラメータを設定します。

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