ずんだもんのYouTube自動投稿が失敗したときの原因切り分け｜ログと状態を確認する方法

ずんだもんの動画を自動でYouTubeへ投稿する仕組みでは、動画の作成は終わっているのに投稿されない、投稿されたのに公開されない、失敗メールだけ届かないということがあります。自動処理は一つの作業ではなく、複数の工程が順番に動くためです。

僕が原因を確認するときは、最後の通知から調べません。動画ファイルの作成、保存、認証、アップロード、YouTube側の処理、公開設定、通知の順番に分けます。どこまで終わったかが分かれば、全体を最初からやり直す必要はありません。

自動投稿で勘違いしやすい点

投稿スクリプトを実行しただけで、最新の公開状態まで自動で確認できるとは限りません。外部サービスの処理、認証、公開設定には、それぞれ確認が必要です。

処理を八つに分ける

YouTube Studioから手動でアップロードする場合も、ファイルを選び、タイトルや説明を入力し、公開状態を決める流れになります。画面の名称は更新されることがあるため、ボタンの位置ではなく工程の順序を覚えます。

ファイルが存在しない場合は、YouTubeの認証を調べても原因には届きません。逆に、ファイルがあるのに再生できない場合は、投稿を繰り返さず、まず書き出しを直します。

自動投稿では、アカウントに接続できることと、意図したチャンネルへ投稿できることを分けて確認します。複数チャンネルを管理している場合、認証は成功していても別の投稿先を選んでいることがあります。

ログには開始時刻、処理ID、対象チャンネル、最後に成功した工程、エラーコードだけを残します。アクセストークン、APIキー、アプリパスワード、メール本文の個人情報は記録しません。

アップロード後は、動画が管理画面に存在するかを見ます。存在する場合は、処理中、非公開、限定公開、予約、公開、エラーのどの状態かを確認します。管理画面にあることと、視聴者が見られることは同じではありません。

動画が非公開ならアップロード失敗ではなく公開設定の問題です。予約時刻を過ぎても公開されない場合は、予約日時、タイムゾーン、処理状態を見ます。動画自体が見つからない場合だけ、アップロード工程から再確認します。

エラーが出た直後に最初から再実行すると、YouTube側では動画が作成済みで、同じ動画が二つできる可能性があります。再実行前に、タイトル、ファイル名、開始時刻、動画IDを確認します。

例えば、午後7時に処理を開始し、午後7時02分に動画IDが発行され、午後7時05分に公開設定で止まったなら、原因は動画作成ではなく公開設定を調べます。このように時刻と工程を残すと、次回の確認箇所が絞れます。