ども！今回はYouTube APIを使おうとしている、入門者の方に向けて入れてほしい前提知識について記事にしてみました。YouTube APIとAnalytics and Reporting APIsの二つがあって、組み合わせることであなたの要望が叶えることができるかもしれません。逆説的に、組み合わせ必須かも？
ご挨拶
どもども！プロジェクト外にもちょこちょこ仕事をしている龍ちゃんです。仕事のタイプにもいろいろなものがあります。最近、勉強会の登壇もしているのでその準備もドタバタしています。
今回は、プロジェクト外の仕事で仕入れた知識の放出になります。社内の人のためにプチプロダクト開発を行っていました。プチプロダクトが、三つぐらいは知っていたので実際はプロジェクトぐらいの重さがありますね。新しいことも知れるので、非常に勉強になりました。
さて、本題のために助走をつけていきましょう。今回取り扱うのは、YouTube APIになります。この記事は、前提条件という側面が強いです。具体的にコーディングの部分までは入っていきません。その点はご留意ください。
この記事を通して知ってほしいことは以下になります。
- YouTube APIには大きく分けて２つあり、それぞれ担当する分野がある
- Google のサービスとの連携はGoogle Apps Script（GAS）が一番楽
そんなこんなでぬるっと本編です。
YouTube APIについて
上のほうでもさっくりと書いているのですが、YouTube APIには「YouTube Data API」と「YouTube Aalytics and Reporting APIs」があります。名前からなんとなく切り分けがわかりそうですね。
簡単に切り分けるなら、以下になります。
- 動画のタイトル・投稿日といった動画に対する属性情報
- 特定期間における動画の統計情報（視聴回数・視聴時間・地域・年代 etc…）
これでイメージがわかりやすくなればうれしいです。これの厄介なところについて話していきたいと思います。「YouTube Aalytics and Reporting APIs」の統計情報取得部分です。特定の動画を指定して、統計情報を取得することができますが、「特定の動画」を指定する部分は「YouTube Data API」経由で取得する必要があります。「YouTube Aalytics and Reporting APIs」だけで取得する場合は、視聴回数上位の動画の統計情報というざっくりとした取り方しかできません。
例えば以下のシナリオがあるとします。
このシナリオをかなえるためには、「自分が所有しているすべての動画」を取得して、その動画が「先月だけでどれだけ再生されたか」を検索する必要があります。
一つのシナリオをかなえるために、二つのAPIを組み合わせて実行しなければならないのです。先ほども言いましたがIDだけが紐づけられています。動画のタイトルや投稿日を取得するためには「YouTube Data API」が必要になります。
ちなみに厄介と言っていますが、公式のリファレンスにはしっかりと書いてあります。読まない人が悪いのですが、ハードルが高いのもわかります。僕もリファレンスを泣きながら読んで、１%ぐらい理解しました。
Google サービスとの連携はGASが良い
ここでは、「YouTube API を使用して作業したいときはGoogle Apps Script（GAS）が良い」というお話を強めに書いていこうと思います。利点としては以下になります。
- OAuth周りの設定を明示的にやらなくてよい（GCPを経由しなくてよい）
- 公式がサンプルを用意してくれている
やはり、どちらも提供元がGoogleという利点もあります。YouTube APIを使用する場合は、権限を付与する必要があります。GASを使用すると、必要な権限を設定して認証画面を生成してくれます。
ちゃんとつながっているので、サンプルも充実しています。
このサンプルを見つけるだけでも、APIに対する理解が進むと思います。
おわりに
お疲れ様です。今回は、YouTube APIを使う前の前提知識としての資料をイメージして記事を作成しました。やりたいことの内容としては、YouTube Studioで見れる情報を取るだけなのです。アカウントを共有せずに、統計情報だけをスタックしたいという要望はレアだと思います。Google AnalyticsもYouTube Studioも高機能なので、特別な要望がなければ公式のものを使うことをお勧めします。
レアな要望を頑張って実現するのもエンジニアの醍醐味かもしれません。これからもニッチな需要を攻めていきたいです。ニッチなサンプルを作ったらブログで報告していきますね。
ではまた～
