YouTubeチャンネルのメタデータをバックアップする方法

動画ファイルをダウンロードするだけでは、YouTubeチャンネルの保存として十分ではありません。文書化されたChannel Backupツールは、バックアップに関するドキュメントで、動画メタデータと動画ファイル自体を区別しています。TubeBuddyによると、メタデータのバックアップにはタイトル、タグ、説明を含めることができ、Channelリソースのドキュメントにあるチャンネル情報、再生リストリソースのドキュメントにある再生リストの詳細、Channelリソースのドキュメントにあるサムネイル、再生リストアイテムのドキュメントにある再生リストの順序も保存できます。

適切な方法は、Googleの一度限りのアーカイブが必要なのか、自分の処理で使う構造化された記録が必要なのか、メタデータだけをエクスポートしたいのか、1つ以上のプロフィールを継続的に保護したいのかによって異なります。

YouTubeのメタデータバックアップで保存すべきもの

まず、チャンネル情報を保存します。YouTubeのドキュメントでは、チャンネルのタイトル、説明、カスタムURL、サムネイル、デフォルト言語、国、関連付けられたアップロード用再生リスト、統計情報、公開設定、ブランディング設定、ローカライズ情報などのフィールドが説明されています。Channelリソースのドキュメントを参照してください。

次に、必要な動画単位の記録を保存します。文書化されたChannel Backupツールでは、タイトル、タグ、説明が動画メタデータとして明示されており、動画ファイルではなくCSVとしてエクスポートされます。ドキュメントで確認できます。

再生リストは、単なるリンクの一覧ではなく記録として扱いましょう。YouTubeの再生リストリソースには、タイトル、説明、サムネイル、公開設定、アイテム数、デフォルト言語、ローカライズされたテキスト、ローカライズ情報を含めることができます。再生リストリソースのドキュメントをご覧ください。各再生リストアイテムは、再生リスト、動画ID、0から始まる位置を示すため、その位置によって所属と順序を保存できます。再生リストアイテムのドキュメントを参照してください。

サムネイルは、関連する動画または再生リストの記録と一緒に画像アセットとして保存します。YouTube Data APIを通じてカスタム動画サムネイルを設定し直す場合、サムネイルエンドポイントはJPEGまたはPNGメディアに対応し、ファイルサイズの上限は50 MBです。YouTubeのサムネイルに関するドキュメントによる情報です。

適切なバックアップ方法を選ぶ

Google Takeout：ある時点のアーカイブ

Google Takeoutでは、YouTube動画をエクスポートし、記録の保管やデータ移行のためのアーカイブを作成できます。Googleの説明によると、メール、Google Drive、Dropbox、OneDrive、Boxへの配信、一度限りまたはスケジュールされたエクスポート、ZIPまたはTGZファイル、大きなアーカイブの最大サイズによる分割に対応しています。Googleのエクスポート設定も確認してください。

Googleが管理するエクスポートアーカイブが必要な場合は、この方法を使います。ただしGoogleは、リクエストからアーカイブ作成までの間に行われた変更がアーカイブに含まれない場合があると警告しています。そのため、各エクスポートはライブミラーではなく、ある時点のスナップショットとして扱いましょう。Googleの説明による情報です。

所有者が承認したAPIエクスポート：構造化された記録と非公開データ

YouTube Data APIは、非公開ユーザーデータにOAuth 2.0を使用します。要求するスコープによって、アプリケーションが取得または管理できるリソースが決まり、承認されたサーバーアプリケーションはアクセストークンとリフレッシュトークンを受け取れます。Googleの認証ドキュメントによる説明です。

構造化されたチャンネルや再生リストの記録、または所有者が承認したアクセスが必要な場合に検討する方法です。これはダッシュボードを1回クリックする手順ではなく、実装ワークフローです。

1. OAuth 2.0でアクセスを承認し、エクスポートに必要なスコープだけを要求します。Googleの認証ドキュメントに従ってください。
2. チャンネルリソースを読み取り、保存したいチャンネルフィールドを取得します。YouTubeのChannelリソースのドキュメントを参照してください。
3. チャンネルリソースからcontentDetails.relatedPlaylists.uploadsを読み取り、アップロード用再生リストIDを取得します。Channelリソースのドキュメントに従ってください。playlists.listで再生リストリソースを取得し、続いてplaylistItems.listでその再生リストのアイテムと0から始まる位置を取得します。再生リストリソースのドキュメントおよび再生リストアイテムのドキュメントを参照してください。
4. ページ分割されたリストのレスポンスを最後まで処理します。次のページがある場合は、nextPageTokenまたはprevPageTokenを次のpageTokenとして使います。YouTubeのページネーションガイドによる方法です。
5. 返された記録を構造化アーカイブに保存します。文書化されたバックアップスクリプトでは、動画と再生リストの記録を別々のJSONファイルとして書き出します。ソースのドキュメントを参照してください。

文書化されたユーザー承認フローの代わりにサービスアカウントを使わないでください。Googleによると、YouTube Data APIはサービスアカウントOAuthに対応しておらず、使用するとNoLinkedYouTubeAccountになります。Googleの認証ドキュメントによる説明です。

CSVまたはJSONツール：動画ファイルなしでメタデータを保存

直近の目的が動画ファイルではなく、検索可能な動画メタデータ台帳である場合、CSVエクスポートが便利です。公開チャンネル向けに文書化された方法の1つは次のとおりです。

1. ログインしてChannel Backupツールを開きます。
2. チャンネルURLを貼り付けます。文書化された手順では、ハンドル、チャンネル、カスタム、従来のユーザーURL形式に対応しています。
3. 「Get Channel Backup」を選択します。
4. 動画メタデータを含むCSVをダウンロードします。文書化された手順による方法です。

YouTube Studio内にも別の方法があります。「Bulk & Misc Tools」を開き、「Misc Tools」を選択して「Channel Backup」を開き、すべての動画または前回のバックアップ以降の動画だけを選択し、結果をCSVとしてエクスポートします。Channel Backupのドキュメントによる手順です。

生のJSONとサムネイルファイルについては、別のメタデータユーティリティが次の方法を説明しています。

1. 動画、再生リスト、チャンネルのURLまたはIDを送信します。
2. 結果をZIPとして保存します。
3. 生成されたabout.txt、video.json、playlist.json、channel.json、利用可能なサムネイルPNGファイルを一緒に保管します。ユーティリティのエクスポートドキュメントによる方法です。

これらの方法は対象範囲が同じではありません。接続アカウントによるCSV方式は読み取り専用と説明されており、有料プランでは限定公開や非公開のアップロードを含められます。一方、表示されている無料プランは最新の公開動画50本に制限され、有料プランは最大50,000本を対象にすると説明されています。現在のツールページを確認し、公開チャンネルのエクスポートを所有者向けの完全なアーカイブとして扱う前に範囲を確認してください。

非公開、限定公開、公開の記録を扱う方法

アクセス権と公開範囲は別の問題です。YouTube Data APIは非公開ユーザーデータにOAuthスコープを使用します。Googleの認証ドキュメントによる説明です。公開URLのエクスポートに非公開または限定公開のアップロードが含まれるとは限りません。接続アカウント型のツールでも、無料プランの公開アクセスと、有料プランの限定公開・非公開アクセスを明確に分けています。現在の対象範囲の説明を確認してください。

各再生リストまたは動画のエントリに、意図した公開範囲を記録します。YouTubeでは、公開アイテムは誰でも視聴・共有でき、限定公開アイテムはリンクを知っている人が視聴・共有でき、非公開アイテムはURLを共有できないと定義しています。YouTubeの公開範囲に関するガイドによる説明です。

再生リストの公開範囲を設定するYouTube Studioの手順は次のとおりです。

1. YouTube Studioにログインします。
2. 「コンテンツ」を選択し、「再生リスト」を選択します。
3. 対象の再生リストで「詳細」を選択します。
4. 「公開設定」を開き、設定を選択します。
5. 「保存」を選択します。YouTubeの再生リスト公開設定手順による方法です。

復元が必要になる前にマニフェストを作成する

アーカイブには1つのインベントリ文書を使います。復旧ガイドでは、チャンネルURLとGoogleまたはブランドアカウントの所有者、ソースまたはマスターファイル、サムネイルのファイル名、デフォルトのタイトル、説明、ハッシュタグとリンク、確認日、復旧担当者を記録することを推奨しています。復旧ガイダンスによる情報です。

チャンネルとその関係を説明する構造化フィールドも追加します。

• チャンネルのタイトル、説明、カスタムURL、サムネイル、デフォルト言語、国、公開設定、ブランディング設定、ローカライズ情報。YouTubeのChannelリソースからの情報です。
• 再生リストのタイトル、説明、サムネイル、公開設定、アイテム数、デフォルト言語、ローカライズされたテキスト、ローカライズ情報。YouTubeの再生リストリソースからの情報です。
• すべての再生リスト所属について、再生リストID、動画ID、0から始まる位置。YouTubeの再生リストアイテムリソースからの情報です。
• 選択したエクスポートにメタデータフィールドが含まれる場合の動画タイトル、タグ、説明。文書化されたChannel Backupの対象範囲からの情報です。

各アーカイブには確認日を付けます。Googleは、エクスポートのリクエストからアーカイブ作成までの間に行われた変更がアーカイブに含まれない可能性があると説明しているためです。Googleの説明による情報です。

CSVまたはJSONからYouTubeのメタデータを復元できますか？

CSVまたはJSONのエクスポートは作業用の記録を提供しますが、YouTube公式のアップロードドキュメントでは、CSV/JSONをネイティブにインポートするのではなく、手動で再構築する方法が説明されています。

1. YouTube Studioで「作成」を選択し、「動画をアップロード」を選択します。
2. 動画ファイルを選択します。
3. 各ファイルの「編集」を選択して動画の詳細を編集します。YouTubeのアップロードドキュメントによる手順です。

YouTubeによると、1回に最大15本の動画をアップロードできます。同じアップロードドキュメントによる情報です。公開範囲を選択する前にアップロード画面を閉じた場合、YouTubeはStudioのコンテンツページで動画を非公開として保存します。YouTubeの説明による情報です。

ツール固有の復元に関する主張は別物です。Channel Backupのドキュメントでは、保存したバックアップファイルをアップロードすると動画のメタデータを復元できると説明しています。ツールのドキュメントによる手順であり、一般的なYouTube標準のCSVまたはJSONインポートではありません。

カスタム動画サムネイルについては、YouTube Data APIのエンドポイントで動画のサムネイルを設定でき、JPEGまたはPNGメディアに対応し、サイズ上限は50 MBです。YouTubeのサムネイルに関するドキュメントによる情報です。

最後に、アーカイブをテストします。復旧ガイダンスでは、20分間の復元訓練を実施することを推奨しています。復旧ガイダンスによる方法です。実際の復旧が急務になる前に、マニフェスト、ソースファイル、サムネイルのファイル名、メタデータ記録、所有権情報、再生リストの順序が揃っていることを確認してください。

定期的なバックアップ計画

Google Takeoutはスケジュールされたエクスポートに対応しています。Googleのエクスポート設定による情報です。SocialGuardianは、YouTubeを含む主要プラットフォームのコンテンツを毎日自動的にバックアップでき、保護対象にはキャプションとメタデータも含まれると説明しています。SocialGuardianの説明をご覧ください。

SocialGuardianの文書化された利用開始手順は次のとおりです。

1. ネットワークを選択します。
2. プロフィールのハンドルまたはURLを入力します。
3. 別のプロフィールを追加する場合は「+ Add another profile」を使います。
4. 開始ページには、トライアルにパスワードが不要と記載されています。SocialGuardianの開始ページによる情報です。

SocialGuardianの公開製品説明では、YouTubeの投稿、ストーリーズ、動画をアーカイブし、キャプションとメタデータを保護すると説明しています。また、パスワードやログインなしで公開@ハンドルからダウンロードまたは復元できるとしています。SocialGuardianの説明をご覧ください。