実装: 検索リクエスト

次の例は、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 メソッドを呼び出して、特定の言語に関連する検索結果を検索します。この例は、クエリ用語が marineq=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