YouTube Data API v3

特徴

すべてのリクエストは、API キー（key パラメータを指定）または OAuth 2.0 のトークンを指定する必要がある
・すべての挿入、更新、および削除のリクエストに認証トークンを送信する必要がある
・認証されたユーザーの非公開データを取得する任意のリクエストにも認証トークンを送信する必要がある

全てのリクエストはAPIキーで管理される
・各リクエストに割り当てられたコストに応じて料金を支払う必要がある

OAuth 2.0 認証
・リソースの挿入、更新、または削除を実行する操作の場合は、常にユーザー認証が必要になる

APIキー

API登録必須
・APIを使用するためには(経由で動画タイトル取得するためには)、API登録が必要となる
・「認証なし」と掲載されているコードがあるが、この意味は「OAuth 2.0」認証が不要なだけで、API登録は必須
・API登録せず動画タイトル取得するためには、スクレイピングするしかない

APIキーの制限
・取得したAPIキーを誰かが不正に使用した場合、そのコストはキー取得者が負う仕様となっている
・キー取得者は不正使用されないよう、制限を設定しなければいけない

クォータ

従量課金制度
・料金体系のひとつ
・サービスを利用した量に応じて、請求金額が変化する

OAuth 2.0 認証

リダイレクトURL指定必須
・後から少しでもURL変更すると、登録しているリダイレクトURLも変更しなければいけないため、とても面倒
・400エラー表示例

リクエストURL

キーの制限

キーを制限すると、このキーを使用できるウェブサイト、IP アドレス、またはアプリを指定できる

APIキーに対して、「HTTP リファラー 制限」を設定した例

APIキー
・★★

制限事項
・HTTP リファラー

認証情報

*.w4c.work/*

※上記で期待した結果を取得できないことがある。理由不明。その場合は「IP アドレス制限」へ変更する

APIキーに対して制限を設定せずにリクエストした結果例

デフォルト設定でリクエスト

{

 "kind": "youtube#activityListResponse",

 "etag": "\"g7k5f8kvn67Bsl8L-Bum53neIr4/CE6jaXHjxf4xIiNsQqdhpw9gsS4\"",

 "nextPageToken": "CAUQAA",

 "pageInfo": {

  "totalResults": 20,

  "resultsPerPage": 5

 },

 "items": [

  {

   "kind": "youtube#activity",

   "etag": "\"g7k5f8kvn67Bsl8L-Bum53neIr4/u04SB_igoOdd86oTcm62dkRwIyI\"",

   "id": "QlVMMTUxNjMwNjU3NDk0MjM0MjQwODYyOTky",

   "snippet": {

    "publishedAt": "2018-01-18T20:16:14.000Z",

    "channelId": "UCMlwQuZJJQppHO6-FkGgiqQ",

    "title": "Nintendo Labo(ニンテンドーラボ) 初公開映像",

    "description": "Nintendo Labo(ニンテンドーラボ) 初公開映像\n\n【Nintendo Labo(ニンテンドーラボ)】\nhttp://www.nintendo.co.jp/labo/\n\n動画に含まれる情報は公開日時点のものです。",

    "thumbnails": {

     "default": {

      "url": "https://i.ytimg.com/vi/X-RLOcV9L68/default.jpg",

      "width": 120,

      "height": 90

     },

     "medium": {

      "url": "https://i.ytimg.com/vi/X-RLOcV9L68/mqdefault.jpg",

      "width": 320,

      "height": 180

     },

     "high": {

      "url": "https://i.ytimg.com/vi/X-RLOcV9L68/hqdefault.jpg",

      "width": 480,

      "height": 360

     },

     "standard": {

      "url": "https://i.ytimg.com/vi/X-RLOcV9L68/sddefault.jpg",

      "width": 640,

      "height": 480

     },

     "maxres": {

      "url": "https://i.ytimg.com/vi/X-RLOcV9L68/maxresdefault.jpg",

      "width": 1280,

      "height": 720

     }

    },

    "channelTitle": "Popular on YouTube - Japan",

    "type": "bulletin"

   }

  },

  {

   "kind": "youtube#activity",

   "etag": "\"g7k5f8kvn67Bsl8L-Bum53neIr4/P5THnWmZHSWppsZ3vYaAvZ4Aw9Q\"",

   "id": "QlVMMTUxNjIyMDE3Njk0MjM0MjQwODYzNTY4",

   "snippet": {

    "publishedAt": "2018-01-17T20:16:16.000Z",

    "channelId": "UCMlwQuZJJQppHO6-FkGgiqQ",

    "title": "【黒猫のウィズ】シュガーレスバンビーナ PV",

    "description": "「クイズRPG 魔法使いと黒猫のウィズ」\n近日公開の新イベント「シュガーレスバンビーナ」のPVを公開！\n\n醜い大人になりたくないと、少女はその心に鍵をかけ、子供であり続けることを選んだ。 \n汚れた獣に支配された、腐った世界で生き抜くために――。\n\n※画面は開発中のものです。\n※動画の内容は変更になる場合があります。\n\nチャンネル登録はコチラ→https://www.youtube.com/channel/UCDOD89CZCNdJZPPM1hudUPQ?sub_confirmation=1\n\n\nクイズRPG 魔法使いと黒猫のウィズ 公式サイト：\nhttp://colopl.co.jp/magicianwiz/\n\nクイズRPG 魔法使いと黒猫のウィズ 公式Twitter：\nhttps://twitter.com/colopl_quiz\n\n＜好評配信中！！＞\nAndroid版：\nhttps://play.google.com/store/apps/details?id=jp.colopl.quizwiz\niOS版：\nhttps://itunes.apple.com/jp/app/id621106129\n\n～解きはなて！すべての知識が魔法になる～\n叡智の扉。それは、108の異界を繋ぐ全の円環。\n扉は正しき理により解きはなたれ、神秘の力を具現する。\n人は力を魔法と名付け、扉の解放者を魔法使いと呼称した。\nこれは、魔法が日常に寄り添う世界の\nとある魔法使いの物語――\n「クイズRPG 魔法使いと黒猫のウィズ」は、クイズに答えながらクエストを進めるクイズ＆カードバト\u00ad\u00ad\u00ad\u00ad\u00adルRPGです。ゲームの舞台は魔法の息づく架空世界・クエス＝アリアス。プレ\u00adイ\u00adヤ\u00adー\u00adは\u00ad魔法使いとなり、人びとからの依頼や事件を解決したり他の魔法使いと\u00ad知識\u00adを競\u00adった\u00adりし\u00adながら一流の魔法使いを目指します。\n\nーーーーーーーーーーーーーーーーーーーーーーーーーーー\n・対応スマートデバイスの購入および通信料はお客様のご負担となります。\n・アイテム課金制です。一部キャラクターは有料のランダム型アイテム提供方式により提供されます。\n・20歳未満の方へ：アイテムを購入する際は、保護者から同意をもらうか、一緒に購入するようにしてください。\nーーーーーーーーーーーーーーーーーーーーーーーーーーー",

    "thumbnails": {

     "default": {

      "url": "https://i.ytimg.com/vi/xvHPAVapnuY/default.jpg",

      "width": 120,

      "height": 90

     },

     "medium": {

      "url": "https://i.ytimg.com/vi/xvHPAVapnuY/mqdefault.jpg",

      "width": 320,

      "height": 180

     },

     "high": {

      "url": "https://i.ytimg.com/vi/xvHPAVapnuY/hqdefault.jpg",

      "width": 480,

      "height": 360

     },

     "standard": {

      "url": "https://i.ytimg.com/vi/xvHPAVapnuY/sddefault.jpg",

      "width": 640,

      "height": 480

     },

     "maxres": {

      "url": "https://i.ytimg.com/vi/xvHPAVapnuY/maxresdefault.jpg",

      "width": 1280,

      "height": 720

     }

    },

    "channelTitle": "Popular on YouTube - Japan",

    "type": "bulletin"

   }

  },

  {

   "kind": "youtube#activity",

   "etag": "\"g7k5f8kvn67Bsl8L-Bum53neIr4/fYs3KpDVGeXp2EyrFkeysk7kiU0\"",

   "id": "QlVMMTUxNjEzMzc3NTk0MjM0MjQwODYyODAw",

   "snippet": {

    "publishedAt": "2018-01-16T20:16:15.000Z",

    "channelId": "UCMlwQuZJJQppHO6-FkGgiqQ",

    "title": "15コの機能が詰まった最強スコップ入手しました！",

    "description": "↓本日の米↓\n思った以上に雪が積もったわけでございましてTwitterフォローしてる方は知ってるかと思いますがカズトラック終了しましたw。雪が積もっただけでなくトラックの目の前に人口の滑り台も無事に完成しましてソリで気軽に遊べるようになりました。まっ引きこもりだから無問題さ！\n\n↓今回のスコップ販売ページ\nhttps://www.amazon.co.jp/o/ASIN/B01K6X4K6K/kazuch09240a-22\n\n↓香川のイベント応募はこちらから\nhttp://www.sanukieigasai.com/info/index.html?pScinfo143\n\nあっちなみにですが、最近というかここ一年うどんにすごいはまってます。香川はうどんの国なので今から行くのが楽しみで仕方ありません。炭水化物ばんざーい。\n\n\n\n\n↓使用機材\nGH5 http://amzn.to/2qUiFDh \nレンズズーム http://amzn.to/2pWbd6z\nレンズ単焦点 http://amzn.to/2qvsw1s\nマイク大 http://amzn.to/2qyT53Q\nマイク小 http://amzn.to/2rhB10L\nGoPro5 http://amzn.to/2qUj1Kh\nRX100M5 http://amzn.to/2pZ1WK8\nFDR-X3000 http://amzn.to/2pZ4gRo\nクイックシュー http://amzn.to/2qyRyL6\nGC550 http://amzn.to/2qyRRFE\n三脚旅用 http://amzn.to/2qUmW9U\n三脚部屋用 http://amzn.to/2rtDe6s\nDRONE http://amzn.to/2pYQNsN\n\n\n◆カズさんのTwitter\nhttps://twitter.com/kazuch0924\n\n◆カズさんのインスタ\nhttps://www.instagram.com/kazuch0924/\n\n◆カズ嫁のTwitter\nhttps://twitter.com/8jizeninsyugo\n\n------------------------------------------------------------------------------ \n楽曲提供：Production Music by http://www.epidemicsound.com \n------------------------------------------------------------------------------\n\n\nどれもボチボチ動画更新中！\n◆カズチャンネル登録↓\nhttp://bit.ly/kazuch-T\n◆カズ飯チャンネル登録↓\nhttp://bit.ly/kazumeshi-T\n◆カズゲームズチャンネル登録↓\nhttp://bit.ly/kazugames-T\n\n\n【プロフィール】\n福井在住のカズです。\n小学校時代は遊ぶ友達があまりいなかったので\n練り消し作り・一人学校探検で休み時間を過ごしてました。\nえぇ、ごくごく普通の人です。\n\nとりあえず一度きりの人生、後悔しないよう\nいろんな事やってみてる所なう。\n\n↓ファンレターの宛先はコチラ\n〒106-6137\n 東京都港区六本木 6-10-1\n六本木ヒルズ森タワー 37階\nカズさん宛\n\n↓お仕事のご依頼はこちらから\nhttp://www.uuum.co.jp/inquiry_promotion",

    "thumbnails": {

     "default": {

      "url": "https://i.ytimg.com/vi/pGKob-QBaTw/default.jpg",

      "width": 120,

      "height": 90

     },

     "medium": {

      "url": "https://i.ytimg.com/vi/pGKob-QBaTw/mqdefault.jpg",

      "width": 320,

      "height": 180

     },

     "high": {

      "url": "https://i.ytimg.com/vi/pGKob-QBaTw/hqdefault.jpg",

      "width": 480,

      "height": 360

     },

     "standard": {

      "url": "https://i.ytimg.com/vi/pGKob-QBaTw/sddefault.jpg",

      "width": 640,

      "height": 480

     },

     "maxres": {

      "url": "https://i.ytimg.com/vi/pGKob-QBaTw/maxresdefault.jpg",

      "width": 1280,

      "height": 720

     }

    },

    "channelTitle": "Popular on YouTube - Japan",

    "type": "bulletin"

   }

  },

  {

   "kind": "youtube#activity",

   "etag": "\"g7k5f8kvn67Bsl8L-Bum53neIr4/jD3EpuiKV9JY9pexxmF4xFnaf2k\"",

   "id": "QlVMMTUxNjA0NzM3NDk0MjM0MjQwODYxMDA4",

   "snippet": {

    "publishedAt": "2018-01-15T20:16:14.000Z",

    "channelId": "UCMlwQuZJJQppHO6-FkGgiqQ",

    "title": "過去最高額きた？年末ジャンボ宝くじの高額当選を受け取りに銀行に行った結果",

    "description": "いいなと思っていただけたら高評価押してください！再生数よりもこちらを参考にして動画を作りたい！！そして少しでも面白いなと思っていただけたらぜひ【チャンネル登録】お願いします！\n（尊敬する水溜りボンドさんを参考に丁寧にパクらさせていただきました）\n\nジョーさんのチャンネルはこちら\nhttps://www.youtube.com/user/joevlog7\n\n★チャンネル登録はこちら\nhttps://www.youtube.com/channel/UCaminwG9MTO4sLYeC3s6udA?sub_confirmation=1\n\n★ヒカルのゲーム実況チャンネル\nhttps://www.youtube.com/user/kinnpatuhikaru\n\n★ヒカルのTwitter\nhttps://twitter.com/kinnpatuhikaru\n\n★ヒカルのインスタグラム\nhttps://www.instagram.com/tadanokarisuma/\n\n・VAZ公式HP\nhttp://vaz.tokyo/",

    "thumbnails": {

     "default": {

      "url": "https://i.ytimg.com/vi/m0JXXZhlRiM/default.jpg",

      "width": 120,

      "height": 90

     },

     "medium": {

      "url": "https://i.ytimg.com/vi/m0JXXZhlRiM/mqdefault.jpg",

      "width": 320,

      "height": 180

     },

     "high": {

      "url": "https://i.ytimg.com/vi/m0JXXZhlRiM/hqdefault.jpg",

      "width": 480,

      "height": 360

     },

     "standard": {

      "url": "https://i.ytimg.com/vi/m0JXXZhlRiM/sddefault.jpg",

      "width": 640,

      "height": 480

     },

     "maxres": {

      "url": "https://i.ytimg.com/vi/m0JXXZhlRiM/maxresdefault.jpg",

      "width": 1280,

      "height": 720

     }

    },

    "channelTitle": "Popular on YouTube - Japan",

    "type": "bulletin"

   }

  },

  {

   "kind": "youtube#activity",

   "etag": "\"g7k5f8kvn67Bsl8L-Bum53neIr4/gSRvpo2PXdj01btUMU90TFxA_i4\"",

   "id": "QlVMMTUxNTk2MDk3NDk0MjM0MjQwODYwMzY4",

   "snippet": {

    "publishedAt": "2018-01-14T20:16:14.000Z",

    "channelId": "UCMlwQuZJJQppHO6-FkGgiqQ",

    "title": "ネタ会議の様子を初公開！ネタ提案プレゼン大会！としみつ編",

    "description": "虫眼鏡編\n→https://youtu.be/uJnUjDHOeyQ\nりょう編\n→https://youtu.be/WvkXzxm7x4c\nゆめまる編\n→https://youtu.be/jY7LtnSXvOI\nてつや編\n→https://youtu.be/lGsy6a5pUWM\n(編集：てつや)\n\n\nどうも、東海オンエアです。\nぜひチャンネル登録お願いします！\n\nサブチャンネル【東海オンエアの控え室】もぜひチャンネル登録してね！！！\nhttps://www.youtube.com/channel/UCynIYcsBwTrwBIecconPN2A\n\n\nお仕事の依頼はこちらから\nhttps://www.uuum.co.jp/inquiry_promotion\n\nファンレターはこちらへ\n〒106-6137 東京都港区六本木 6-10-1 六本木ヒルズ森タワー 37階UUUM株式会社　東海オンエア宛\n\n【Twitterアカウント】\nてつや→https://twitter.com/TO_TETSUYA\nとしみつ→https://twitter.com/TO_TOSHIMITSU\nしばゆー→https://twitter.com/TOKAI_ONAIR\nりょう→https://twitter.com/TO_RYOO\nゆめまる→https://twitter.com/TO_yumemarucas\n虫眼鏡→https://twitter.com/TO_ZAWAKUN",

    "thumbnails": {

     "default": {

      "url": "https://i.ytimg.com/vi/iSfIzlJOzwA/default.jpg",

      "width": 120,

      "height": 90

     },

     "medium": {

      "url": "https://i.ytimg.com/vi/iSfIzlJOzwA/mqdefault.jpg",

      "width": 320,

      "height": 180

     },

     "high": {

      "url": "https://i.ytimg.com/vi/iSfIzlJOzwA/hqdefault.jpg",

      "width": 480,

      "height": 360

     },

     "standard": {

      "url": "https://i.ytimg.com/vi/iSfIzlJOzwA/sddefault.jpg",

      "width": 640,

      "height": 480

     },

     "maxres": {

      "url": "https://i.ytimg.com/vi/iSfIzlJOzwA/maxresdefault.jpg",

      "width": 1280,

      "height": 720

     }

    },

    "channelTitle": "Popular on YouTube - Japan",

    "type": "bulletin"

   }

  }

 ]

}

APIキーに対して制限を設定してリクエストした結果例

HTTP リファラー 制限した上でリクエスト

{

 "error": {

  "errors": [

   {

    "domain": "usageLimits",

    "reason": "ipRefererBlocked",

    "message": "The request did not specify any referer. Please ensure that the client is sending referer or use the API Console to remove the referer restrictions.",

    "extendedHelp": "https://console.developers.google.com/apis/credentials?project=1658009173"

   }

  ],

  "code": 403,

  "message": "The request did not specify any referer. Please ensure that the client is sending referer or use the API Console to remove the referer restrictions."

 }

}

リソースとは？

一意の識別子を持つ個別のデータ エンティティ

リソースの種類

API を使用してやり取りできる各種リソース

activities
・特定のチャンネルまたはユーザーが、YouTube で行った操作に関する情報が格納されている
・アクティビティ フィードに報告される操作には、動画の評価、動画の共有、お気に入りへの動画の追加、動画へのコメントの投稿、動画のアップロードなどがある
・各 activity リソースは、操作の種類、操作に関連付けられたチャンネル、および操作に関連付けられたリソース（評価またはアップロードされた動画など）を識別する

channelBanners
・新しくアップロードされた画像をチャンネル用のバナー画像として設定するために使う URL が含まれている

channels
・YouTube チャンネルに関する情報が格納されている

guideCategories
・コンテンツや人気などの指標に基づいて YouTube がチャンネルに関連付けるカテゴリを示す
・チャンネルの人気度などのインジケータに基づいて YouTube がアルゴリズム的に割り当てるカテゴリを識別する
・guideCategory により、YouTube ユーザーが目的のコンテンツを容易に見つけられるようにチャンネルを整理できる
・チャンネルは 1 つ以上のガイド カテゴリに関連付けられる場合があるが、何らかのガイド カテゴリに属することが保証されているわけではない
・チャンネルのコンテンツや、このリストは video categories と似ている
・異なる点は、動画をアップロードしたユーザーは動画カテゴリを割り当てることができるが、チャンネル カテゴリを割り当てられるのは YouTube だけである

playlistItems
・再生リストに含まれている動画などの別のリソースを識別する
・含まれているリソースが再生リストでどのように使用されるかに関連する、リソースについての詳細が含まれている
・YouTube は再生リストを使って、次に示すようなチャンネルごとの動画の特別なコレクションを識別する
・具体的には、これらのリストは、個人、グループ、または会社の動画、再生リスト、および他の YouTube 情報のコレクションで、チャンネルに関連付けられている
・特定のチャンネルに対するこれらのリストの再生リスト ID を channel resource から取得できる
・そのあと、 playlistItems.list メソッドを使って対応するリストを取得できる
・また、playlistItems.insert メソッドや playlistItems.delete メソッドを呼び出すことで、これらのリストにアイテムを追加したり、削除したりできる
・たとえば、動画をお気に入りに追加すると、その動画はそのユーザーのチャンネルのお気に入り動画の再生リストに挿入される

playlists
・YouTube の再生リストを表す
・再生リストとは、順序を付けて表示し、他のユーザーと共有できる動画のコレクションを指す
・再生リストには最大 200 本の動画を登録できる
・また、各ユーザーが作成する再生リストの数に制限はない
・デフォルトでは再生リストは他のユーザーに一般公開されるが、一般公開または非公開にすることができる
・また YouTube では再生リストを使って、次に示すようなチャンネルの動画の特殊なコレクションを識別する
・より具体的には、これらのリストは、個人、グループ、または会社の動画、再生リスト、および他の YouTube 情報のコレクションで、チャンネルに関連付けられている
・特定のチャンネルに対するこれらのリストの再生リスト ID を channel resource から取得できる
・そのあと、playlistItems.list メソッドを使って対応するリストを取得できる
・playlistItems.insert メソッドや playlistItems.delete メソッドを呼び出すことで、これらのリストにアイテムを追加したり、削除したりできる

search
・検索結果には、API リクエストで指定した検索パラメータに一致する YouTube 動画、チャンネル、または再生リストに関する情報が含まれる
・検索結果は、動画など一意に識別可能なリソースを出力するが、検索結果自体は永続的なデータを持たない

subscriptions
・YouTube ユーザーの登録チャンネルに関する情報が含まれる
・登録チャンネルは、新しい動画がチャンネルに追加されたり、別のユーザーが動画のアップロード、動画の評価、動画へのコメントといった、YouTube でなんらかの操作を行った場合、ユーザーに通知する

thumbnails
・リソースに関連付けられたさまざまなサムネイル画像のサイズを識別する
・サムネイル画像には次の特性がある
・リソースの snippet.thumbnails プロパティは、そのリソースに使用可能なサムネイル画像を識別するオブジェクトである
・thumbnail リソースには一連のオブジェクトが含まれている
・各オブジェクトの名前（default、medium、high など）はサムネイル画像のサイズを表す
・さまざまな種類のリソースで、さまざまなサイズのサムネイル画像をサポートできる
・さまざまな種類のリソースで、同じ名前のサムネイル画像に対してさまざまなサイズを定義できる
・たとえば default サムネイル画像（video リソース）は通常 120 x 90 ピクセルで、default サムネイル画像（channel リソース）は通常 88 x 88 ピクセル
・同じ種類のリソースで、元の画像や YouTube にアップロードされたコンテンツの解像度によって、特定の画像に対してさまざまなサイズのサムネイル画像を指定できる
・たとえば HD 動画は、HD 以外の動画よりも高解像度のサムネイルをサポートできる
・サムネイル画像のサイズについての情報が含まれている各オブジェクトは、width プロパティと height プロパティを持つ
・ただし width と height のプロパティがその画像に対して返されないことがある
・アップロードされたサムネイル画像が必要な寸法に一致しない場合、その画像はアスペクト比を変更することなく、正しいサイズに合わせてサイズ変更される
・画像はトリミングされないが、サイズが正しくなるように黒いバーが含まれる場合がある

videoCategories
・アップロードした動画に関連付けられているか、関連付けることができるカテゴリを識別する

videos
・単一の YouTube 動画を表す

メソッド一覧

list メソッド
・認証されたリクエストと認証されていないリクエストの両方がサポートされている
・認証されていないリクエストの場合、取得できるのは公開されているデータだけだが、認証されたリクエストの場合は現在の認証ユーザーに関する情報、または現在の認証ユーザーに対して非公開の情報も取得できる

一覧

メソッド	内容	OAuth 2.0 認証
list	0 個以上のリソースのリストを取得（GET）	-
insert	新しいリソースを作成（POST）	◯
update	リクエストのデータに応じて既存のリソースを変更（PUT）	◯
delete	特定のリソースを削除（DELETE）	◯

一番利用頻度が高いと思われるリソース／メソッド

Videos: list

現在使用可能なバージョン

2013年に公開されたv3のみ

APIキー

v3
・API登録必須

v2
・API登録不要で動画情報取得可能

リクエストURL

-	v3	v2
URL	https://www.googleapis.com	http://gdata.youtube.com/

ネットで検索して情報取得

注意事項
・バージョン明記していない場合があるため紛らわしい

2015年

3月8日
・この時点では、まだV2も正常動作していた

2014年

3月4日
・v2 正式にサポート終了

2013年

1月16日
・v3 公開開始

5月10日
・v2 API のほとんどを 2015 年 4 月 20 日に廃止すると発表

2007年

8月28日
・新しいYouTube APIをリリース







・改訂履歴