実装: 検索リクエスト

次の例は、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

チャンネル

この例では、クエリ語句「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 パラメータなどのオプションの検索パラメータと組み合わせて使用できます。

注: このクエリは、APIs Explorer では実際には結果を返しません。APIs Explorer は動画のアップロードをサポートしていないためです。このクエリは APIs Explorer の外部で独自のアプリケーションに対して実行できますが、APIs Explorer を使用してアプリケーションの結果を取得することはできません。

アップロードされた各動画には、Google Cloud コンソールでデベロッパーのアプリケーションに関連付けられているプロジェクト番号が自動的にタグ付けされます。

検索リクエストで forDeveloper パラメータが true に設定されると、API サービスはリクエストの認証情報を使用してデベロッパーを識別します。したがって、デベロッパーは、他のアプリやサイト経由でアップロードされた動画ではなく、デベロッパー自身のアプリまたはウェブサイト経由でアップロードされた動画に結果を制限できます。

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.search.list?
        part=snippet
        &q=fun
        &forDeveloper=true