Google Takeout の YouTube データ ― どのファイルに何が入っているか

書き出しの基本：時間・分割・期限

Takeout は、Google アカウントのデータをファイルにまとめて書き出す Google の公式の仕組みです。YouTube は Google Takeout の一覧から選びます。「YouTube と YouTube Music」の中の「すべての YouTube データが含まれます」を押すと、種類ごとに入れる・外すを選べ、履歴は HTML と JSON のどちらで出すかも選べます。

書き出しの仕様は、Google アカウント ヘルプの「データをダウンロードする」 に書かれています。2026 年 10 月に確かめた内容は次のとおりです。

• 時間。アカウントの情報量によって数分から数日かかります。ほとんどの人は、依頼した当日にリンクが届くと書かれています。
• 形式と分割。.zip と .tgz から選べます。上限サイズより大きくなると複数のファイルに分かれ、分割を減らすには上限を 50GB にします。
• 期限と回数。アーカイブは約 7 日で期限切れになり、ダウンロードは 1 つのアーカイブにつき 5 回までです。
• 期間は選べない。書き出すデータの期間は指定できません。毎回、残っている全期間が出ます。
• 定期的な書き出し。「2 か月ごとに 1 年間」というエクスポートも選べます。

フォルダ構成とファイル名

zip を開くと、いちばん上に Takeout フォルダがあり、その下の「YouTube and YouTube Music」フォルダ（日本語の画面で出したときは「YouTube と YouTube Music」）に、種類ごとのフォルダが並びます。フォルダ名とファイル名は、Takeout を使った言語の表示名になります。

古い書き出しでは、コメントとライブチャットが my-comments や my-live-chat-messages というフォルダの HTML ファイルでした。コミュニティ製の Takeout 解析ツール google_takeout_parser の説明にも、同じ名前が旧形式として載っています。

視聴履歴：HTML と JSON のどちらを選ぶか

視聴履歴は、HTML と JSON のどちらかを選んで書き出せます。人が読むなら HTML、表計算やプログラムで扱うなら JSON が向いています。HTML は見た目を整えた文章の中に日時が入っていて、機械で読むと日時の取り違えが起きやすいためです。

JSON の主な項目

視聴履歴の JSON は、1 回の視聴が 1 つの塊になった配列です。項目の並びは、Google の My Activity のスキーマ（Data Portability API） と同じ形で、YouTube では次の項目を読めば足ります。

スキーマには、このほかに activityControls（「YouTube watch history」など、どの履歴の設定に属する記録か）もあります。title の頭は、見た動画なら Watched ですが、同じ履歴の仕組みには「Subscribed to」「Visited」のような別の行動の記録も例として載っています。動画の視聴だけを数えたいときは、titleUrl が watch?v= の形の行だけに絞ると安全です。

広告として再生された動画の見分け方

履歴には、自分で選んだ動画だけでなく、広告として流れた動画も 1 行として入ります。JSON では details の中に「From Google Ads」という名前が付きます（日本語の画面で書き出すと「Google 広告から」）。HTML では、その行のセルに「詳細: Google 広告から」といった注記が付きます。「視聴回数」を数えるときは、この行を除かないと実際より多くなります。

また、視聴履歴は新しい順に並んでいます。同じ動画が履歴の何行に出てくるかが、その動画を見た回数の目安です。ただし YouTube 側で消した履歴や、自動削除の期間より古い分は、Takeout にも入りません。

コメントとライブチャットの CSV

コメントとライブチャットは CSV です。1 行目が見出しで、2 行目から 1 件ずつ並びます。推しログの読み取りで扱っている列の並びは次のとおりです（2026 年 10 月時点）。

2024 年 6 月ごろに、コメントの CSV は列の順番が変わりました（Comment ID が 1 列目から 4 列目に移り、Channel ID が先頭になりました）。古い書き出しと新しい書き出しの CSV を連結すると、列がずれます。「何列目」ではなく、1 行目の見出しの名前で列を選んでください。

• Channel IDは、コメントやチャットをした本人のチャンネルです。コメントされた動画の持ち主のチャンネルは入っていません。持ち主を知りたいときは、動画 ID（Video ID）をもとに、視聴履歴の subtitles と突き合わせます。
• Video IDは動画の 11 文字の ID です。コミュニティ投稿へのコメントは、この列が空になります。
• Parent Comment IDは、名前のとおり返信の親のコメントの ID を入れる列で、返信でないコメントでは空になります。
• Priceが 0 でない行は、有料のコメント（Super Thanks）や有料のライブチャット（Super Chat）です。0 は通常のコメント・チャットです。数字の単位までは、公式の説明を確認できませんでした。金額として足し合わせる前に、手元の数行を YouTube の表示と見比べてください。
• Comment Text / Live Chat Textは、文章を細かく区切った JSON の文字列になっています。本文が改行やカンマを含むため、セルの中に改行が入る行があります。

登録チャンネルと、そのほかのファイル

登録チャンネルの subscriptions.csv は、見出しが Channel Id, Channel URL, Channel Title の 3 列です。チャンネル ID（UC で始まる）、チャンネルの URL、チャンネル名が入ります。登録した日の列はありません。いつ登録したかは、Takeout からは分かりません。

• 高評価。2026 年 10 月に確かめた書き出しでは、ほとんど入っていません。
• 検索履歴。history フォルダに、視聴履歴とは別のファイルで入ります。検索した言葉がそのまま残るので、共有するときは特に気をつけます。
• 動画ファイル。自分が投稿した動画は videos フォルダに、元のファイルが入ります。zip が大きくなる原因の大半はここです。

項目やファイルが見当たらないとき

YouTube の項目の一覧は、アカウントのデータによって変わります。2026 年 9 月に確かめた範囲では、コメントの記録が無いアカウントには、「コメント」と「ライブ チャット」という項目自体が出ませんでした。コメントをしたことがなければ、項目が無いのは普通のことです。

• ブランドアカウントのとき。チャンネルをブランドアカウントで作っていると、見たい動画やコメントが別のアカウントに入っています。Google のヘルプにも、ブランドアカウントを使っているときはそのアカウントに切り替える、と書かれています。複数あるときは、1 つずつ書き出します。
• 登録チャンネルが入っていないとき。subscriptions.csv が見当たらないときは、詳細で「登録チャンネル」にチェックが付いているかを確かめて、書き出し直します。
• 履歴が短いとき。履歴の自動削除を設定していると、その期間より前の分は Google 側に残っておらず、Takeout にも出ません。

日時の書式とタイムゾーン

同じ瞬間でも、ファイルによって日時の書式が違います。表計算に読み込む前に、どれなのかを確かめてください。

日付ごとに数えるときは、UTC のまま日付を切り出すと、日本時間では前日・翌日にずれます。たとえば UTC の 2024 年 9 月 3 日 12:15 は、日本時間では同じ日の 21:15 ですが、UTC の 15:00 以降は日本時間では翌日になります。夜に見ることが多い人ほど、数え方次第で日付別の集計が変わります。

個人情報として扱う

Takeout のファイルは、見た動画・探した言葉・書いた文章・登録しているチャンネルの記録そのものです。趣味や関心、生活の時間帯まで読み取れます。人に送るときや、オンラインの変換サービスに載せるときは、中身を必ず見てからにしてください。

• 表計算で開く作業は、できるだけ自分のパソコンの中で済ませる。
• 誰かに見せたい部分だけを別のファイルに写し、元のファイルは渡さない。コメントの Channel ID から、自分のチャンネルは特定されます。
• 使い終わったら、ダウンロードした zip と解凍したフォルダを消す。メールで届いたリンクも、期限が切れるまでは有効です。

推しログでは

推しログには、この zip を選ぶだけで、視聴履歴・コメント・ライブチャット・登録チャンネルを推し活の記録として取り込む画面があります。ブラウザの中で読み取り、広告再生の除外や日本時間の日付への変換は自動で行います。手順は Takeout で YouTube の視聴履歴を取り出して、推し活の記録にする方法 にまとめています。