Search

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

Methods

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

list

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

リソース表現

次の 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
  }
}

プロパティ

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