検索方法のメモです。

準備

---

Google API ConsoleでYouTube Data APIを有効化し、
API keyを取得しておきます。
　
　

ドキュメント

---

検索方法は以下ドキュメントに記載されています。

YouTube Data API (v3) Search: list
　
　

検索例

---

”ゲーム”をキーワードとして検索する例です。
HOGE_KEYは取得したkeyに置き換えて下さい。

・動画
https://www.googleapis.com/youtube/v3/search?key=HOGE_KEY&part=snippet&type=video&maxResults=50&order=date&q=%E3%82%B2%E3%83%BC%E3%83%A0

・ライブ(配信中)
eventType=liveを指定します。

https://www.googleapis.com/youtube/v3/search?key=HOGE_KEY&part=snippet&type=video&eventType=live&&maxResults=50&order=date&q=%E3%82%B2%E3%83%BC%E3%83%A0

・ライブ(配信終了したもの)
eventType=completedを指定します。

https://www.googleapis.com/youtube/v3/search?key=HOGE_KEY&part=snippet&type=video&eventType=completed&maxResults=50&order=date&q=%E3%82%B2%E3%83%BC%E3%83%A0
　
　

検索結果

---

レスポンスはjson形式になっています。
以下は動画を3件検索した例です(maxResults=3)。

{
 "kind": "youtube#searchListResponse",
 "etag": "\"I_8xdZu766_FSaexEaDXTIfEWc0/RKUynPMn3BmnTGqg9VtzeHMKgAk\"",
 "nextPageToken": "CAMQAA",
 "regionCode": "JP",
 "pageInfo": {
  "totalResults": 1000000,
  "resultsPerPage": 3
 },
 "items": [
  {
   "kind": "youtube#searchResult",
   "etag": "\"I_8xdZu766_FSaexEaDXTIfEWc0/ghpWdGHaIXMsHBWfNkUCd4sBWQY\"",
   "id": {
    "kind": "youtube#video",
    "videoId": "yCH9JpU6UC4"
   },
   "snippet": {
    "publishedAt": "2016-10-24T13:01:31.000Z",
    "channelId": "UCkS_L8KIQ93C4zMcMrWudkA",
    "title": "なんかいろいろゲームするよ",
    "description": "なんんかいろいろゲームやるよ ひますとだと棒読みちゃんが読んでくれるかも http://himast.in/st/shu_ya007.",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/vi/yCH9JpU6UC4/default_live.jpg",
      "width": 120,
      "height": 90
     },
     "medium": {
      "url": "https://i.ytimg.com/vi/yCH9JpU6UC4/mqdefault_live.jpg",
      "width": 320,
      "height": 180
     },
     "high": {
      "url": "https://i.ytimg.com/vi/yCH9JpU6UC4/hqdefault_live.jpg",
      "width": 480,
      "height": 360
     }
    },
    "channelTitle": "しゅーや",
    "liveBroadcastContent": "live"
   }
  },
  {
   "kind": "youtube#searchResult",
   "etag": "\"I_8xdZu766_FSaexEaDXTIfEWc0/8Ogtb5vJ4N5FAQnbAqCLkfzXNmE\"",
   "id": {
    "kind": "youtube#video",
    "videoId": "iua2RIbCyzw"
   },
   "snippet": {
    "publishedAt": "2016-10-24T12:03:17.000Z",
    "channelId": "UC30aMAX06UMuGST8MeKOjyw",
    "title": "ゲーム実況",
    "description": "主に、ゲーム実況やっています!チャンネル登録してくれると喜びます(^^) /BO3/FARCRY/Minecraft/GTA5/パワプロ/ twitterにて、随時実況状況をお知らせしま...",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/vi/iua2RIbCyzw/default.jpg",
      "width": 120,
      "height": 90
     },
     "medium": {
      "url": "https://i.ytimg.com/vi/iua2RIbCyzw/mqdefault.jpg",
      "width": 320,
      "height": 180
     },
     "high": {
      "url": "https://i.ytimg.com/vi/iua2RIbCyzw/hqdefault.jpg",
      "width": 480,
      "height": 360
     }
    },
    "channelTitle": "tukasa pantu",
    "liveBroadcastContent": "none"
   }
  },
  {
   "kind": "youtube#searchResult",
   "etag": "\"I_8xdZu766_FSaexEaDXTIfEWc0/aRz7QzXa_lRg82xAUjXGK1g8_NI\"",
   "id": {
    "kind": "youtube#video",
    "videoId": "NKzkKHSm5po"
   },
   "snippet": {
    "publishedAt": "2016-10-24T11:52:36.000Z",
    "channelId": "UCeuve7jOhKIEu1Nsu0ElPLg",
    "title": "【ソーマの実況】 おお？アプデ入ってゲームチャットのまま招待出来るようになった？の巻【PS4版 BF1】",
    "description": "試してみよう！",
    "thumbnails": {
     "default": {
      "url": "https://i.ytimg.com/vi/NKzkKHSm5po/default.jpg",
      "width": 120,
      "height": 90
     },
     "medium": {
      "url": "https://i.ytimg.com/vi/NKzkKHSm5po/mqdefault.jpg",
      "width": 320,
      "height": 180
     },
     "high": {
      "url": "https://i.ytimg.com/vi/NKzkKHSm5po/hqdefault.jpg",
      "width": 480,
      "height": 360
     }
    },
    "channelTitle": "souma ryuu",
    "liveBroadcastContent": "none"
   }
  }
 ]
}