Search

検索結果には、API リクエストで指定した検索パラメータに一致する YouTube 動画、チャンネル、再生リストに関する情報が含まれます。検索結果は動画など一意に識別可能なリソースを指していますが、検索結果には独自の永続データはありません。

Methods

この API では、検索について以下のメソッドがサポートされています。

list
API リクエストで指定されたクエリ パラメータに一致する検索結果のコレクションを返します。デフォルトでは、検索結果セットは一致する videochannelplaylist のリソースを識別しますが、特定のタイプのリソースのみを取得するようにクエリを構成することもできます。こちらから今すぐお試しください。

リソース表現

次の JSON 構造は、検索結果の形式を示しています。

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

プロパティ

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

プロパティ
kind string
API リソースのタイプを識別します。値は youtube#searchResult です。
etag etag
このリソースの Etag。
id object
id オブジェクトには、検索リクエストに一致するリソースを一意に識別するために使用できる情報が含まれています。
id.kind string
API リソースのタイプ。
id.videoId string
id.type プロパティの値が youtube#video の場合は、このプロパティが存在し、その値には、検索クエリに一致する動画を一意に識別するために YouTube によって使用される ID が含まれます。
id.channelId string
id.type プロパティの値が youtube#channel の場合は、このプロパティが存在し、その値には、検索クエリに一致するチャンネルを一意に識別するために YouTube によって使用される ID が含まれます。
id.playlistId string
id.type プロパティの値が youtube#playlist の場合は、このプロパティが存在し、その値には、YouTube が検索クエリに一致するプレイリストを一意に識別するために使用する ID が含まれます。
snippet object
snippet オブジェクトには、タイトルや説明など、検索結果に関する基本情報が含まれます。たとえば、検索結果が動画の場合、タイトルはその動画のタイトルで、説明はその動画の説明です。
snippet.publishedAt datetime
検索結果によって特定されるリソースの作成日時。値は ISO 8601 形式で指定します。
snippet.channelId string
検索結果で識別されたリソースを公開したチャンネルを一意に識別するために YouTube が使用する値。
snippet.title string
検索結果のタイトル。
snippet.description string
検索結果の説明。
snippet.thumbnails object
検索結果に関連付けられたサムネイル画像のマップ。マップ内の各オブジェクトでは、キーはサムネイル画像の名前で、値はサムネイルに関するその他の情報を含むオブジェクトになります。
snippet.thumbnails.(key) object
有効な Key-Value は次のとおりです。
  • default – デフォルトのサムネイル画像。動画(または、再生リストのアイテムや検索結果など、動画を参照するリソース)のデフォルト サムネイルは幅 120px、高さ 90px です。チャンネルのデフォルト サムネイルは幅 88px、高さ 88px です。
  • medium - サムネイル画像の高解像度バージョン。動画(または動画を参照するリソース)の場合、この画像は幅 320px、高さ 180px です。チャンネルの場合は、幅 240px、高さ 240px です。
  • high - サムネイル画像の高解像度バージョン。動画(または動画を参照するリソース)の場合、この画像は幅 480px、高さ 360px です。チャンネルの場合、幅 800px、高さ 800px です。
  • standard - high 解像度画像よりもさらに高解像度のサムネイル画像。この画像は、再生リストのアイテムや検索結果など、動画を参照する一部の動画やリソースで使用できます。この画像は幅 640 ピクセル、高さ 480 ピクセルです。
  • maxres - サムネイル画像の最高解像度バージョン。この画像サイズは、動画のほか、再生リストのアイテムや検索結果など動画を参照するその他のリソースでも利用できます。この画像は幅 1,280 ピクセル、高さ 720 ピクセルです。
snippet.thumbnails.(key).url string
画像の URL。
snippet.thumbnails.(key).width unsigned integer
画像の幅。
snippet.thumbnails.(key).height unsigned integer
画像の高さ。
snippet.channelTitle string
検索結果によって識別されるリソースを公開したチャンネルのタイトル。
snippet.liveBroadcastContent string
video リソースまたは channel リソースにライブ ブロードキャスト コンテンツがあるかどうかを示します。有効なプロパティ値は upcominglivenone です。
video リソース、値 upcoming は、動画がまだ開始されていないライブ ブロードキャストであることを示します。値 live は、アクティブなライブ ブロードキャストであることを示します。channel リソースの場合、値 upcoming は、チャンネルでまだ開始されていないスケジュール設定済みのブロードキャストがあることを示し、値 live は、チャンネルにアクティブなライブ ブロードキャストがあることを示します。