弊社では、YouTubeチャンネル動画のタイトルやURL、概要欄などのテキスト情報を一括で保存できる、YouTubeチャンネル動画の詳細設定一括保存ツールを提供しています。
YouTube APIキーとYouTubeチャンネルIDを入力すれば、YouTubeチャンネル動画のテキスト情報をCSV形式でダウンロードできるツールです。
下記のようなケースで活用できます。
- 動画タイトルや概要欄、タグなどを変更する前に保存して、変更後の成果を分析する
- 競合のチャンネル動画をチェックする
- アップしている動画のテキスト情報を報告する
今回は、このツールで出力されるCSVの解説を行います。
YouTube APIキーやYouTubeチャンネルIDの確認方法は、過去の記事にてご紹介しております。
YouTubeチャンネル動画 詳細設定一括保存ツールの使い方
YouTubeチャンネル動画 詳細設定一括保存ツールで出力されるCSV
保存したCSVをExcelやGoogleスプレッドシートなどの表計算ソフトで開くと、このように表示されます。
各項目はこのようになっています。
※例は【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説の場合です
| 項目名 | 解説 | 例 |
|---|---|---|
| video URL | 動画URL | https://www.youtube.com/watch?v=RJjd6WZsYSU |
| title | 動画タイトル | 【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説 |
| description | 動画の概要欄（説明文） | 皆さん、こんにちは。 株式会社火燵です。…… |
| thumbnails | サムネイル画像のURL | https://i.ytimg.com/vi/RJjd6WZsYSU/hqdefault.jpg |
| tags | 動画のタグ ※ハッシュタグではありません | [‘GoProHero11’, ‘GoPro11初心者向け解説動画’, ……] |
| viewCount | 視聴回数 | 7497 |
| commentCount | 動画につけられたコメントの数 | 4 |
| likeCount | 高評価数 | 51 |
| dislikeCount | 低評価数 ※現在、不具合によりうまく取得されません | 0 |
| duration | 動画の再生時間（秒） | 1094 |
| categoryId | 動画のカテゴリ番号 | 26 |
| publishedAt | 協定世界時（UTC）での公開日時 | 2022-11-28T10:36:26Z |
CSV 各項目解説
では【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説の動画を例に、出力したCSVの各項目について詳しく解説していきましょう。
video URL / title / discription
URL / タイトル / 概要欄
video URLは、YouTube動画の右下ボタン「共有」を選択したときに表示されるURL形式（https://youtu.be/動画ID）ではなく、通常のURL（https://www.youtube.com/watch?v=動画ID）で出力されます。
「共有」で表示されるのは、SNSなどでシェアしやすく省略したURLであるため、このツールでは正式な動画URLである https://www.youtube.com/watch?v=動画ID の形式となります。
title（タイトル）とdescription（概要欄）は、それぞれ原文のまま出力されます。また、description（概要欄）に含まれる改行も、その通りに反映されます。
thumbnails：サムネイル画像のURL
サムネイルは元々、YouTubeによって自動的に5種類のサイズで生成され、それぞれ異なるURLで参照できます。
各サイズとURLを下記にまとめました。
| 種類 | サイズ | URL |
|---|---|---|
| デフォルト | 120 × 90 | http://img.youtube.com/vi/動画ID/default.jpg |
| 高画質 | 320 × 180 | http://img.youtube.com/vi/動画ID/mqdefault.jpg |
| 中画質 | 480 × 360 | http://img.youtube.com/vi/動画ID/hqdefault.jpg |
| 標準画質 | 640 × 480 | http://img.youtube.com/vi/動画ID/sddefault.jpg |
| 最大解像度 | 1920 × 1080 | http://img.youtube.com/vi/動画ID/maxresdefault.jpg |
CSVのthumbnailsで出力されるのは、中画質（480 × 360）のURL（http://img.youtube.com/vi/動画ID/hqdefault.jpg）です。
例えば「【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説」の場合なら、下記のサムネイルを参照します。
【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説 サムネイル
https://i.ytimg.com/vi/RJjd6WZsYSU/hqdefault.jpgtags：タグ
tagsは動画投稿設定の下部にある「タグ」の項目です。
概要欄に記述するハッシュタグとは別です。
設定したタグは、[‘タグ1’, ‘タグ2’, ……] という形式で出力されます。
viewCount / commentCount / likeCount / dislikeCount
視聴回数 / コメント数 / 高評価数 / 低評価数
これらは、動画分析の上で重視される数値です。
commentCount（コメント数）は、スパムや削除されたものなどを含めてカウントしているため、実際にコメント欄に表示されている数と合わない場合があります。
実際に「【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説」ではコメント数は4つとありますが、YouTubeのコメント欄で確認できるのは2つです。
dislikeCount（低評価数）は仕様により、うまく取得されません。実際に低評価があっても「0」と表記されてしまうため、現在調整中です。
「【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説」でも、実際には5つ低評価が入っていますが、CSVのdislikeCountは「0」と表示されています。
duration：再生時間（秒）
動画の再生時間の秒数です。
秒数表示で分かりにくいため、Excelなどの表計算ソフトで時間の形式に変換する必要があります。
例で挙げている「【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説」なら、下記の計算式で時間単位に変換できます。
1094 / 60 = 18.2333…（分）
0.2333… * 60 = 13.8（秒）
したがって、18分13秒となります。これで実際のYouTube再生時間表記と同じ結果となりました。
categoryId：カテゴリ番号
投稿時に設定する動画カテゴリの番号です。
動画投稿時、下の方にある「カテゴリ」が該当部分です。
YouTubeではカテゴリ名のみで番号は表記されていませんが、CSVではID番号で表示されます。
これはYouTube APIの都合上、カテゴリ名を直接出力できないためです。
主な番号とカテゴリ名はこちらです（日本の場合）。
| ID | カテゴリ名 |
|---|---|
| 1 | 映画とアニメ |
| 2 | 自動車と乗り物 |
| 10 | 音楽 |
| 15 | ペットと動物 |
| 17 | スポーツ |
| 18 | ショート ムービー |
| 19 | 旅行とイベント |
| 20 | ゲーム |
| 21 | 動画ブログ |
| 22 | ブログ |
| 23 | コメディー |
| 24 | エンターテイメント |
| 25 | ニュースと政治 |
| 26 | ハウツーとスタイル |
| 27 | 教育 |
| 28 | 科学と技術 |
| 30 | 映画 |
| 31 | アニメ |
| 32 | アクション/アドベンチャー |
| 33 | クラシック |
| 34 | コメディー |
| 35 | ドキュメンタリー |
| 36 | ドラマ |
| 37 | 家族向け |
| 38 | 海外 |
| 39 | ホラー |
| 40 | SF/ファンタジー |
| 41 | サスペンス |
| 42 | 短編 |
| 43 | 番組 |
| 44 | 予告編 |
「【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説」であれば「26」と表記されているため、「ハウツーとスタイル」が該当します。
ただ、割り振られる番号とカテゴリは変わることがあります。
最新のカテゴリ種別は、YouTube API リファレンス公式ページで確認ができます。
カテゴリ確認方法
最新のカテゴリ情報を知りたいときは、下記の手順でカテゴリ一覧を取得します。
https://developers.google.com/youtube/v3/docs/videoCategories/list?hl=ja
アクセスすると、上記ページが開きます。
右側にある「Try this method」の入力欄にそれぞれ以下のように記入します。
snippet
ja
JP
「Credentials」の下にあるチェックは入れたままで、「Execute」をクリックします。
Googleアカウントの選択画面が表示されます。
該当のアカウントを選択して、「許可」をクリックします。
問題なければ、「Try this method」の一番下に「200」という見出しとJSON形式のコードが表示されます。
これが、最新のYouTubeカテゴリ一覧です。
これをChatGPTなどのAIツールに依頼して、表の形式に変換すれば使いやすくなります。ぜひお試しください。
publishedAt：公開日時（UTC）
協定世界時（UTC）での動画公開日時です。
YouTubeでは通常、投稿した日付は確認できますが、何時にアップしたかは確認できません。
他者のチャンネル動画だけでなく、ご自身のも同様です。YouTube Studioでは、投稿日付のみしか表示されません。
しかしこのツールでは、チャンネル内にある動画の投稿日時を一括で取得できます。どの時間帯にアップした動画の成果が良かったか、分析するときに役立つでしょう。
特定の国の時間基準に合わせるには、Excelのような表計算ソフトで時間を変換する必要があります。
日本時間にする場合は、publishedAtに9時間加算しましょう。
「【初心者向け】GoPro HERO 11 Blackのカメラ設定について解説」であれば、10:36:26に9時間加えます。
日本時間にすると、19:36:26に公開したことがわかります。
まとめ
このように、YouTubeチャンネル動画の詳細設定一括保存ツールから出力したCSVは、さまざまなデータが取得できます。ぜひ分析などにお役立てください。
YouTube APIキーやYouTubeチャンネルIDの確認方法は、過去の記事からご覧ください。
次回は、このCSVを使ったGoogleスプレッドシートカスタマイズ例をご紹介いたします。
