YouTube Data API は、YouTube の動画、チャンネル、再生リスト、コメントなどを外部アプリから扱うための API です。公開情報の取得だけでなく、適切な認証を通せば動画投稿、再生リスト管理、コメント管理、ライブ配信設定の一部なども扱えます。
まず押さえたいポイント
- YouTube のデータ取得と一部の管理操作を行う中心的なAPI
- チャンネル、動画、検索、コメント、再生リストなどの単位で扱う
- 公開情報の取得は API キーで足りる場面がある
- 投稿や非公開データの参照、管理操作では OAuth 2.0 が必要
- YouTube Analytics API や YouTube Reporting API とは役割が違う
どんな場面で使うか
よくある使い方は、動画一覧を自社サイトに出す、特定チャンネルの新着動画を取得する、再生リストを埋め込む前提で並び順やメタ情報を取得する、コメント欄の状態を外部ツールから確認する、といったものです。CMS や社内ダッシュボードから YouTube の運用情報を扱いたいときにも候補になります。
また、公開データを見るだけでなく、認証済みの利用者の代わりに動画をアップロードしたり、サムネイルや再生リストを更新したりする用途でも使われます。ただし、何でも API キーだけでできるわけではなく、管理系の操作ではユーザー本人の同意を伴う OAuth 2.0 認可が前提になります。
よくある誤解
YouTube Data API を使えば、YouTube Studio で見える情報を全部そのまま扱えると思うのは誤解です。分析用途の詳細データは YouTube Analytics API や YouTube Reporting API の担当で、ライブ配信の管理も Live Streaming API の考え方が関わります。
もうひとつの誤解は、サーバー同士の連携だからサービスアカウントでよいと考えることです。YouTube Data API の公式案内では、サービスアカウント方式はサポートされず、YouTube アカウントにリンクできないためエラーになると説明されています。つまり、YouTube チャンネル本人の権限で扱う設計が基本です。
注意点
YouTube Data API は便利ですが、クォータ制限があります。検索系メソッドは軽く連打すると消費が大きくなりやすく、ページネーションでも追加コストが積み上がります。何を毎回検索するのか と ID指定で済む取得に変えられないか を先に整理した方が安全です。
全体像をつかみたい場合は、YouTube APIでできることとは？動画取得・投稿・分析・ライブ管理の違い で、Data API と Analytics API などの違いをまとめています。