Search: list

API リクエストで指定されたクエリ パラメータに一致する検索結果のコレクションを返します。デフォルトでは、検索結果セットにより一致する video、channel、playlist リソースが識別されますが、特定の種類のリソースのみを取得するようにクエリを構成することもできます。

割り当てへの影響: このメソッドを呼び出すと、100 ユニットの割り当てコストが発生します。

一般的なユースケース

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/youtube/v3/search

パラメータ

次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
part	string part パラメータは、API レスポンスに含める 1 つ以上の search リソース プロパティをカンマ区切りのリストで指定します。パラメータ値を snippet に設定します。
フィルタ（次のパラメータの 0 または 1 を指定）
forContentOwner	boolean このパラメータは、適切に承認されたリクエストでのみ使用できます。YouTube コンテンツ パートナー専用です。 forContentOwner パラメータは、onBehalfOfContentOwner パラメータで識別されるコンテンツ所有者が所有する動画のみを検索するように制限します。forContentOwner が true に設定されている場合、リクエストは次の要件も満たしている必要があります。 onBehalfOfContentOwner パラメータは必須です。 リクエストを承認するユーザーは、指定したコンテンツ所有者にリンクされたアカウントを使用する必要があります。 type パラメータ値は video に設定する必要があります。 他のパラメータ videoDefinition、videoDimension、videoDuration、videoEmbeddable、videoLicense、videoPaidProductPlacement、videoSyndicated、videoType は設定できません。
forDeveloper	boolean このパラメータは、適切に承認されたリクエストでのみ使用できます。forDeveloper パラメータは、デベロッパーのアプリケーションまたはウェブサイト経由でアップロードされた動画のみを取得するように検索を制限します。API サーバーはリクエストの承認認証情報を使用してデベロッパーを識別します。forDeveloper パラメータは、q パラメータなどのオプションの検索パラメータと組み合わせて使用できます。 この機能では、アップロードされた各動画には、Google Developers Console でデベロッパーのアプリケーションに関連付けられているプロジェクト番号が自動的にタグ付けされます。 その後、検索リクエストで forDeveloper パラメータが true に設定されると、API サーバーはリクエストの承認認証情報を使用してデベロッパーを識別します。そのため、デベロッパーは、検索結果をデベロッパー自身のアプリやウェブサイト経由でアップロードされた動画に限定できますが、他のアプリやサイト経由でアップロードされた動画に限定することはできません。
forMine	boolean このパラメータは、適切に承認されたリクエストでのみ使用できます。forMine パラメータは、認証されたユーザーが所有する動画のみを取得するように検索を制限します。このパラメータを true に設定する場合は、type パラメータの値も video に設定する必要があります。また、他のパラメータ videoDefinition、videoDimension、videoDuration、videoEmbeddable、videoLicense、videoPaidProductPlacement、videoSyndicated、videoType を同じリクエストで設定することはできません。
オプション パラメータ
channelId	string channelId パラメータは、API レスポンスにチャンネルによって作成されたリソースのみが含まれることを示します。 注: リクエストで channelId パラメータの値を指定し、type パラメータ値を video に設定した場合、forContentOwner、forDeveloper、forMine フィルタのいずれも設定しない場合、検索結果は最大 500 本に制限されます。
channelType	string channelType パラメータを使用すると、検索を特定の種類のチャネルに制限できます。 有効な値は次のとおりです。 any – すべてのチャンネルを返します。 show – 番組のみを取得します。
eventType	string eventType パラメータは、検索対象をブロードキャスト イベントに制限します。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 completed – 完了したブロードキャストのみを含めます。 live – アクティブなブロードキャストのみを含めます。 upcoming – 今後のブロードキャストのみを含めます。
location	string location パラメータは locationRadius パラメータと組み合わせて円形の地理的エリアを定義します。また、検索対象を、そのエリア内の地理的位置をメタデータで指定している動画に限定します。パラメータ値は、緯度と経度の座標を指定する文字列です（例: 37.42307,-122.08427）。 location パラメータ値は領域の中心点を識別します。 locationRadius パラメータは、動画に関連付けられた場所から、その地点までの動画が検索結果に含まれるまでの最大距離を指定します。 リクエストで location パラメータの値が指定されていて、locationRadius パラメータの値も指定されていない場合、API はエラーを返します。 注: このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。
locationRadius	string locationRadius パラメータは location パラメータと組み合わせて円形の地理的エリアを定義します。 パラメータ値は、浮動小数点数の後に測定単位を付けて指定する必要があります。有効な測定単位は m、km、ft、mi です。たとえば、有効なパラメータ値には 1500m、5km、10000ft、0.75mi があります。この API では、1,000 キロメートルを超える locationRadius パラメータ値はサポートされません。 注: 詳しくは、location パラメータの定義をご覧ください。
maxResults	unsigned integer maxResults パラメータは、結果セットで返されるアイテムの最大数を指定します。有効な値は 0～50 です。デフォルト値は 5 です。
onBehalfOfContentOwner	string このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは YouTube コンテンツ パートナー専用です。 onBehalfOfContentOwner パラメータは、リクエストの認証情報が、パラメータ値で指定されたコンテンツ所有者の代理である YouTube CMS ユーザーを識別することを示します。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネル データにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。
order	string order パラメータは、API レスポンス内のリソースを並べ替えるために使用するメソッドを指定します。デフォルト値は relevance です。 指定できる値は次のとおりです。 date – リソースは作成日の新しい順に並べ替えられます。 rating – リソースは評価が高い順に並べられます。 relevance – リソースは、検索クエリとの関連性に基づいて並べ替えられます。このパラメータのデフォルト値です。 title – リソースをタイトルのアルファベット順に並べ替えます。 videoCount – アップロードされた動画の数を降順で並べ替えます。 viewCount – リソースを表示回数の多い順に並べ替えます。ライブ配信の場合、ブロードキャストの進行中、動画は同時視聴者数で並べ替えられます。
pageToken	string pageToken パラメータは、結果セットの特定のページを返します。API レスポンスでは、nextPageToken プロパティと prevPageToken プロパティは取得可能な他のページを示します。
publishedAfter	datetime publishedAfter パラメータは、指定した時刻以降に作成されたリソースのみが API レスポンスに含まれることを示します。この値は RFC 3339 形式の date-time 値です（1970-01-01T00:00:00Z）。
publishedBefore	datetime publishedBefore パラメータは、指定した時刻より前または指定した時刻に作成されたリソースのみが API レスポンスに含まれることを示します。この値は RFC 3339 形式の date-time 値です（1970-01-01T00:00:00Z）。
q	string q パラメータは、検索する検索キーワードを指定します。 リクエストでは、ブール演算子の NOT（-）と OR（|）を使用して、動画を除外したり、複数の検索キーワードのいずれかに関連付けられている動画を検索したりすることもできます。たとえば、「ボート」または「セーリング」のいずれかに一致する動画を検索するには、q パラメータの値を boating|sailing に設定します。同様に、「ボート」または「セーリング」に一致し、「釣り」には一致しない動画を検索するには、q パラメータの値を boating|sailing -fishing に設定します。パイプ文字を API リクエストで送信するときには、URL エスケープする必要があります。パイプ文字の URL エスケープ値は %7C です。
regionCode	string regionCode パラメータは、指定した国で視聴できる動画の検索結果を返すように API に指示します。パラメータ値は ISO 3166-1 alpha-2 国コードです。
relevanceLanguage	string relevanceLanguage パラメータは、指定された言語に最も関連性のある検索結果を返すように API に指示します。パラメータ値は通常、ISO 639-1 で規定されている 2 文字の言語コードです。ただし、簡体字中国語には zh-Hans、繁体字中国語には zh-Hant という値を使用する必要があります。検索キーワードとの関連性が高い場合、他の言語の検索結果も引き続き返されます。
safeSearch	string safeSearch パラメータは、検索結果に標準のコンテンツと制限付きコンテンツのどちらを含めるかを示します。 有効な値は次のとおりです。 moderate – YouTube は検索結果から一部のコンテンツをフィルタします。少なくとも、ユーザーの言語 / 地域で制限されているコンテンツはフィルタします。動画の内容によっては、検索結果から動画が削除されたり検索結果内での優先度が下がったりすることがあります。これはデフォルトのパラメータ値です。 none – YouTube は検索結果セットをフィルタしません。 strict – YouTube は検索結果セットからすべての制限付きコンテンツを除外しようとします。動画の内容によっては、検索結果から動画が削除されたり検索結果内での優先度が下がったりすることがあります。
topicId	string topicId パラメータは、指定したトピックに関連付けられたリソースのみが API レスポンスに含まれることを示します。この値は Freebase トピック ID を識別します。 重要: Freebase と Freebase API のサポート終了に伴い、2017 年 2 月 27 日より topicId パラメータの動作が変わりました。その時点で、YouTube は厳選された少数のトピック ID のサポートを開始しました。このパラメータの値として使用できるのは、その一部の ID のみです。 2017 年 2 月 15 日時点でサポートされているトピック ID を確認する トピック 音楽トピック /m/04rlf 音楽（親トピック） /m/02mscn クリスチャン ミュージック /m/0ggq0m クラシック音楽 /m/01lyv 国 /m/02lkt エレクトロニック ミュージック /m/0glt670 ヒップホップ ミュージック /m/05rwpb インディーズ音楽 /m/03_d0 ジャズ /m/028sqc アジアの音楽 /m/0g293 ラテンアメリカの音楽 /m/064t9 ポップ ミュージック /m/06cqb レゲエ /m/06j6l リズム アンド ブルース /m/06by7 ロック ミュージック /m/0gywn ソウル ミュージック ゲームのトピック /m/0bzvm2 ゲーム（親トピック） /m/025zzc アクション ゲーム /m/02ntfj アクション アドベンチャー ゲーム /m/0b1vjn カジュアル ゲーム /m/02hygl 音楽ビデオゲーム /m/04q1x3q パズル ビデオゲーム /m/01sjng レース ビデオゲーム /m/0403l3g ロールプレイング ビデオゲーム /m/021bp2 シミュレーション ビデオゲーム /m/022dc6 スポーツの試合 /m/03hf_rm 戦略ビデオゲーム スポーツ トピック /m/06ntj スポーツ（親トピック） /m/0jm_ アメリカン フットボール /m/018jz 野球 /m/018w8 バスケットボール /m/01cgz ボクシング /m/09xp_ クリケット /m/02vx4 フットボール /m/037hz ゴルフ /m/03tmr アイスホッケー /m/01h7lh 総合格闘技 /m/0410tth モータースポーツ /m/07bs0 テニス /m/07_53 バレーボール エンターテイメントに関するトピック /m/02jjt エンターテイメント（親トピック） /m/09kqc ユーモア /m/02vxn 映画 /m/05qjc 舞台芸術 /m/066wd プロレス /m/0f2f9 テレビ番組 ライフスタイルに関するトピック /m/019_rr ライフスタイル（親トピック） /m/032tl ファッション /m/027x7n フィットネス /m/02wbm 食べ物 /m/03glg 趣味 /m/068hy ペット /m/041xxh 身体的魅力 [美容] /m/07c1v テクノロジー /m/07bxq 観光 /m/07yv9 Vehicles 社会のトピック /m/098wr 社会（親トピック） /m/09s1f ビジネス /m/0kt51 Health /m/01h6rj 軍事 /m/05qt0 政治 /m/06bvp 宗教 その他のトピック /m/01k8wb 知識
type	string type パラメータは、特定の種類のリソースのみを取得するように検索クエリを制限します。値はカンマで区切られたリソースのタイプのリストです。デフォルト値は video,channel,playlist です。 指定できる値は次のとおりです。 channel playlist video
videoCaption	string videoCaption パラメータは、API が字幕の有無に基づいて動画検索結果をフィルタするかどうかを示します。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – 字幕の提供状況に基づいて結果をフィルタリングしません。 closedCaption – 字幕のある動画のみを含めます。 none – 字幕のない動画のみを含めます。
videoCategoryId	string videoCategoryId パラメータは、カテゴリに基づいて動画の検索結果をフィルタリングします。このパラメータの値を指定する場合は、type パラメータの値も video に設定する必要があります。
videoDefinition	string videoDefinition パラメータを使用すると、高解像度（HD）または標準画質（SD）の動画のみが含まれるように検索を制限できます。HD 動画は 720p 以上で再生できますが、1080p など、より高い解像度を利用できる場合もあります。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – 解像度に関係なく、すべての動画を返します。 high – HD 動画のみを取得します。 standard – 標準画質の動画のみを取得します。
videoDimension	string videoDimension パラメータを使用すると、2D または 3D 動画のみを取得するように検索を制限できます。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 2d – 検索結果を限定して 3D 動画を除外します。 3d – 検索結果を 3D 動画のみに限定します。 any – 返される結果に 3D 動画と非 3D 動画の両方を含めます。これがデフォルト値です。
videoDuration	string videoDuration パラメータは、動画の検索結果を再生時間に基づいてフィルタします。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – 検索結果を再生時間に基づいてフィルタしません。これがデフォルト値です。 long – 20 分を超える動画のみを含めます。 medium – 長さが 4 ～ 20 分の動画のみを含めます。 short – 4 分未満の動画のみを含めます。
videoEmbeddable	string videoEmbeddable パラメータを使用すると、ウェブページに埋め込むことができる動画のみに検索対象を制限できます。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – 埋め込み可能かどうかにかかわらず、すべての動画を返します。 true – 埋め込み可能な動画のみを取得します。
videoLicense	string videoLicense パラメータは、特定のライセンスを持つ動画のみが含まれるように検索結果をフィルタします。YouTube では、動画をアップロードするユーザーが各動画にクリエイティブ・コモンズ ライセンスまたは標準の YouTube ライセンスを適用できます。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – ライセンスの種類を問わず、クエリ パラメータに一致するすべての動画を返します。 creativeCommon – クリエイティブ・コモンズ ライセンスを持つ動画のみを返します。このライセンスを持つ動画は、動画作成時に誰だれでも再利用できます。詳細 youtube – 標準の YouTube ライセンスを持つ動画のみを返します。
videoPaidProductPlacement	string videoPaidProductPlacement パラメータは、クリエイターが有料プロモーションがあると指定した動画のみを含むように検索結果をフィルタリングします。このパラメータの値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – 有料プロモーションが含まれているかどうかにかかわらず、すべての動画を返します。 true – 有料プロモーションを含む動画のみを取得します。
videoSyndicated	string videoSyndicated パラメータを使用すると、検索対象を youtube.com 以外で再生できる動画のみに制限できます。このパラメータの値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – シンジケートされたかどうかにかかわらず、すべての動画を返します。 true – シンジケーション動画のみを取得します。
videoType	string videoType パラメータを使用すると、検索を特定のタイプの動画に制限できます。このパラメータに値を指定する場合は、type パラメータの値も video に設定する必要があります。 有効な値は次のとおりです。 any – すべての動画を返します。 episode – 番組のエピソードのみを取得します。 movie – ムービーのみを取得します。

リクエスト本文

このメソッドを呼び出す場合は、リクエストの本文を指定しないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "youtube#searchListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "regionCode": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    search Resource
  ]
}

プロパティ

次の表は、検索結果で使用されているプロパティの定義を示したものです。

プロパティ
kind	string API リソースのタイプを識別します。値は youtube#searchListResponse です。
etag	etag このリソースの Etag。
nextPageToken	string 結果セットで次のページを取得するために、pageToken パラメータの値として使用できるトークン。
prevPageToken	string 結果セット内の前のページを取得するために、pageToken パラメータの値として使用できるトークン。
regionCode	string 検索クエリに使用された地域コード。プロパティ値は、地域を識別する 2 文字の ISO 国コードです。i18nRegions.list メソッドは、サポートされているリージョンのリストを返します。デフォルト値は US です。サポートされていない地域が指定されていても、YouTube はクエリを処理するため、デフォルト値ではなく別の地域を選択することがあります。
pageInfo	object pageInfo オブジェクトは、結果セットのページング情報をカプセル化します。
pageInfo.totalResults	integer 結果セット内の結果の合計数。この値は近似値であり、正確な値ではない場合があります。また、最大値は 1,000,000 です。 ページ設定リンクの作成にこの値を使用しないでください。代わりに、nextPageToken プロパティ値と prevPageToken プロパティ値を使用して、ページネーション リンクを表示するかどうかを決定します。
pageInfo.resultsPerPage	integer API レスポンスに含まれる結果の数。
items[]	list 検索条件に一致する結果のリスト。

例

注: 次のコードサンプルは、サポートされているプログラミング言語の一部を示しているわけではありません。サポートされている言語の一覧については、クライアント ライブラリのドキュメントをご覧ください。

Apps ScriptGo.NETRuby

この関数は、キーワード「dogs」に関連する動画を検索します。検索結果の動画 ID とタイトルが Apps Script ログに記録されます。

このサンプルでは、結果が 25 件に制限されていることに注意してください。より多くの結果を返すには、https://developers.google.com/youtube/v3/docs/search/list に記載されている追加のパラメータを渡します。

function searchByKeyword() {
  var results = YouTube.Search.list('id,snippet', {q: 'dogs', maxResults: 25});

  for(var i in results.items) {
    var item = results.items[i];
    Logger.log('[%s] Title: %s', item.id.videoId, item.snippet.title);
  }
}
youtube.gs

このコードサンプルは、API の search.list メソッドを呼び出して、特定のキーワードに関連付けられた検索結果を取得します。

この例では、Go クライアント ライブラリを使用します。

package main

import (
        "flag"
        "fmt"
        "log"
        "net/http"

        "google.golang.org/api/googleapi/transport"
        "google.golang.org/api/youtube/v3"
)

var (
        query      = flag.String("query", "Google", "Search term")
        maxResults = flag.Int64("max-results", 25, "Max YouTube results")
)

const developerKey = "YOUR DEVELOPER KEY"

func main() {
        flag.Parse()

        client := &http.Client{
                Transport: &transport.APIKey{Key: developerKey},
        }

        service, err := youtube.New(client)
        if err != nil {
                log.Fatalf("Error creating new YouTube client: %v", err)
        }

        // Make the API call to YouTube.
        call := service.Search.List("id,snippet").
                Q(*query).
                MaxResults(*maxResults)
        response, err := call.Do()
        handleError(err, "")

        // Group video, channel, and playlist results in separate lists.
        videos := make(map[string]string)
        channels := make(map[string]string)
        playlists := make(map[string]string)

        // Iterate through each item and add it to the correct list.
        for _, item := range response.Items {
                switch item.Id.Kind {
                case "youtube#video":
                        videos[item.Id.VideoId] = item.Snippet.Title
                case "youtube#channel":
                        channels[item.Id.ChannelId] = item.Snippet.Title
                case "youtube#playlist":
                        playlists[item.Id.PlaylistId] = item.Snippet.Title
                }
        }

        printIDs("Videos", videos)
        printIDs("Channels", channels)
        printIDs("Playlists", playlists)
}

// Print the ID and title of each result in a list as well as a name that
// identifies the list. For example, print the word section name "Videos"
// above a list of video search results, followed by the video ID and title
// of each matching video.
func printIDs(sectionName string, matches map[string]string) {
        fmt.Printf("%v:\n", sectionName)
        for id, title := range matches {
                fmt.Printf("[%v] %v\n", id, title)
        }
        fmt.Printf("\n\n")
}
search_by_keyword.go

次のコードサンプルでは、API の search.list メソッドを呼び出して、特定のキーワードに関連付けられた検索結果を取得します。

This example uses the .NET client library.

using System;
using System.Collections.Generic;
using System.IO;
using System.Reflection;
using System.Threading;
using System.Threading.Tasks;

using Google.Apis.Auth.OAuth2;
using Google.Apis.Services;
using Google.Apis.Upload;
using Google.Apis.Util.Store;
using Google.Apis.YouTube.v3;
using Google.Apis.YouTube.v3.Data;

namespace Google.Apis.YouTube.Samples
{
  /// <summary>
  /// YouTube Data API v3 sample: search by keyword.
  /// Relies on the Google APIs Client Library for .NET, v1.7.0 or higher.
  /// See https://developers.google.com/api-client-library/dotnet/get_started
  ///
  /// Set ApiKey to the API key value from the APIs & auth > Registered apps tab of
  ///   https://cloud.google.com/console
  /// Please ensure that you have enabled the YouTube Data API for your project.
  /// </summary>
  internal class Search
  {
    [STAThread]
    static void Main(string[] args)
    {
      Console.WriteLine("YouTube Data API: Search");
      Console.WriteLine("========================");

      try
      {
        new Search().Run().Wait();
      }
      catch (AggregateException ex)
      {
        foreach (var e in ex.InnerExceptions)
        {
          Console.WriteLine("Error: " + e.Message);
        }
      }

      Console.WriteLine("Press any key to continue...");
      Console.ReadKey();
    }

    private async Task Run()
    {
      var youtubeService = new YouTubeService(new BaseClientService.Initializer()
      {
        ApiKey = "REPLACE_ME",
        ApplicationName = this.GetType().ToString()
      });

      var searchListRequest = youtubeService.Search.List("snippet");
      searchListRequest.Q = "Google"; // Replace with your search term.
      searchListRequest.MaxResults = 50;

      // Call the search.list method to retrieve results matching the specified query term.
      var searchListResponse = await searchListRequest.ExecuteAsync();

      List<string> videos = new List<string>();
      List<string> channels = new List<string>();
      List<string> playlists = new List<string>();

      // Add each result to the appropriate list, and then display the lists of
      // matching videos, channels, and playlists.
      foreach (var searchResult in searchListResponse.Items)
      {
        switch (searchResult.Id.Kind)
        {
          case "youtube#video":
            videos.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.VideoId));
            break;

          case "youtube#channel":
            channels.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.ChannelId));
            break;

          case "youtube#playlist":
            playlists.Add(String.Format("{0} ({1})", searchResult.Snippet.Title, searchResult.Id.PlaylistId));
            break;
        }
      }

      Console.WriteLine(String.Format("Videos:\n{0}\n", string.Join("\n", videos)));
      Console.WriteLine(String.Format("Channels:\n{0}\n", string.Join("\n", channels)));
      Console.WriteLine(String.Format("Playlists:\n{0}\n", string.Join("\n", playlists)));
    }
  }
}
Search.cs

このサンプルでは、API の search.list メソッドを呼び出して、特定のキーワードに関連付けられた検索結果を取得します。

この例では、Ruby クライアント ライブラリを使用しています。

#!/usr/bin/ruby

require 'rubygems'
gem 'google-api-client', '>0.7'
require 'google/api_client'
require 'trollop'

# Set DEVELOPER_KEY to the API key value from the APIs & auth > Credentials
# tab of
# {{ Google Cloud Console }} <{{ https://cloud.google.com/console }}>
# Please ensure that you have enabled the YouTube Data API for your project.
DEVELOPER_KEY = 'REPLACE_ME'
YOUTUBE_API_SERVICE_NAME = 'youtube'
YOUTUBE_API_VERSION = 'v3'

def get_service
  client = Google::APIClient.new(
    :key => DEVELOPER_KEY,
    :authorization => nil,
    :application_name => $PROGRAM_NAME,
    :application_version => '1.0.0'
  )
  youtube = client.discovered_api(YOUTUBE_API_SERVICE_NAME, YOUTUBE_API_VERSION)

  return client, youtube
end

def main
  opts = Trollop::options do
    opt :q, 'Search term', :type => String, :default => 'Google'
    opt :max_results, 'Max results', :type => :int, :default => 25
  end

  client, youtube = get_service

  begin
    # Call the search.list method to retrieve results matching the specified
    # query term.
    search_response = client.execute!(
      :api_method => youtube.search.list,
      :parameters => {
        :part => 'snippet',
        :q => opts[:q],
        :maxResults => opts[:max_results]
      }
    )

    videos = []
    channels = []
    playlists = []

    # Add each result to the appropriate list, and then display the lists of
    # matching videos, channels, and playlists.
    search_response.data.items.each do |search_result|
      case search_result.id.kind
        when 'youtube#video'
          videos << "#{search_result.snippet.title} (#{search_result.id.videoId})"
        when 'youtube#channel'
          channels << "#{search_result.snippet.title} (#{search_result.id.channelId})"
        when 'youtube#playlist'
          playlists << "#{search_result.snippet.title} (#{search_result.id.playlistId})"
      end
    end

    puts "Videos:\n", videos, "\n"
    puts "Channels:\n", channels, "\n"
    puts "Playlists:\n", playlists, "\n"
  rescue Google::APIClient::TransmissionError => e
    puts e.result.body
  end
end

main
search.rb

エラー

次の表に、このメソッドの呼び出しに対して API から返されるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ	エラーの詳細	説明
badRequest (400)	invalidChannelId	channelId パラメータに無効なチャンネル ID が指定されています。
badRequest (400)	invalidLocation	location または locationRadius パラメータ値の形式が正しくありません。
badRequest (400)	invalidRelevanceLanguage	relevanceLanguage パラメータ値の形式が正しくありません。
badRequest (400)	invalidSearchFilter	リクエストに検索フィルタと制限の無効な組み合わせが含まれています。forContentOwner または forMine パラメータを true に設定した場合は、type パラメータを video に設定する必要があります。また、eventType、videoCaption、videoCategoryId、videoDefinition、videoDimension、videoDuration、videoEmbeddable、videoLicense、videoSyndicated、videoType パラメータの値を設定する場合は、type パラメータを video に設定する必要があります。