YouTube投稿をAPI連携で自動化する方法

YouTubeチャンネルを運営していると、動画のアップロード作業が意外と時間を取られます。タイトル、説明文、タグ、サムネイル、公開設定…。1本なら数分で済みますが、複数本をまとめてアップロードしたい場合は、かなりの手間になります。

そこで活用したいのが、YouTube Data API v3です。Googleが公式に提供しているこのAPIを使えば、動画のアップロード、メタデータの設定、予約投稿まで、すべてプログラムから自動化できます。

この記事では、YouTube APIを使った動画アップロードの自動化について、須崎が実際に運用しているワークフローを交えながら解説します。

YouTube Data API v3とは？できることを整理

YouTube Data API v3は、Googleが提供するYouTube操作用の公式APIです。通常はブラウザのYouTube Studio画面から手動で行う操作を、プログラム経由で実行できるようになります。

具体的にできることは、以下のとおりです。

動画アップロード（Resumable Upload対応）

APIを使えば、Pythonなどのスクリプトから動画ファイルを直接アップロードできます。Resumable Upload（再開可能アップロード）に対応しているため、大容量のファイルでも途中で通信が切れた場合に最初からやり直す必要がありません。

メタデータの一括設定

アップロードと同時に、以下のメタデータをプログラムから設定できます。

手動で毎回入力していた項目が、スクリプト1つで自動的に設定されるため、入力ミスやタグの付け忘れがなくなります。

予約投稿（publishAt）

公開状態を「非公開（private）」に設定しつつ、publishAtパラメータで未来の日時を指定すると、その時刻に自動で公開されます。これにより、週末にまとめてアップロードして平日に順次公開するといった運用も可能です。

プレイリスト管理

プレイリストの作成・動画の追加・並び替えもAPIで制御できます。シリーズ動画をアップロードしたら自動でプレイリストに追加する、といった処理も実装可能です。

APIクォータの仕組みと上限

YouTube Data API v3には、1日あたり10,000ユニットのクォータ（デフォルト）が割り当てられています。各APIリクエストには消費ユニット数が決まっており、動画アップロードは1回あたり約1,600ユニットを消費します。

つまり、デフォルトの10,000ユニットでは1日あたり最大6本程度のアップロードが可能です。もしそれ以上必要な場合は、Google Cloud Consoleからクォータの引き上げ申請を行うこともできます。

須崎の場合、14本の一括アップロードを行った際はクォータ引き上げ済みの環境で実施しました。通常の運用であれば、1日数本のアップロードなら十分に収まります。

須崎の実運用ワークフロー

ここからは、須崎が実際にどのようにYouTube APIを活用しているかをご紹介します。

単体アップロード（youtube_upload.py）

1本ずつ動画をアップロードするためのスクリプトです。主な機能は以下のとおりです。

特に重要なのがチャンネル確認ロジックです。複数のYouTubeチャンネルを持っている場合、誤って別のチャンネルにアップロードしてしまうリスクがあります。須崎のスクリプトでは、アップロード前にチャンネル名を自動チェックし、対象チャンネルでなければ処理を中断する仕組みにしています。

一括アップロード（batch_shorts_upload.py）

複数の動画をまとめてアップロードするスクリプトです。須崎はこのスクリプトで14本のYouTube Shortsを一括アップロードした実績があります。

一括アップロードのポイントは以下のとおりです。

1. API制限対策として動画間に3秒の待機時間を挿入
連続でリクエストを送りすぎると、APIが一時的にブロックされる場合があります。3秒のインターバルを入れることで安定したアップロードを実現しています。

2. 全動画を「非公開（下書き）」でアップロード
まず非公開状態でアップロードし、YouTube Studio上で内容を確認してから公開します。万が一メタデータにミスがあっても、視聴者に見られる前に修正できます。

3. アップロード結果のログ出力
成功・失敗の結果をログファイルに記録し、どの動画が正常にアップロードされたかを後から確認できるようにしています。

Remotion + AI連携による自動化ワークフロー

須崎が構築している動画制作の自動化ワークフローは、5つのステップで構成されています。

Step 1: コンテンツ企画 — 過去の視聴データをもとに、AIが次のテーマを提案します。

Step 2: 台本・動画生成 — Remotion（JavaScript/TypeScriptベースの動画生成フレームワーク）でコードから動画を自動生成。台本もAIが作成し、テロップやアニメーションをコードで制御するため再現性の高い動画を量産できます。

Step 3: メタデータ自動生成 — AIがSEOを意識したタイトル・説明文・タグ・ハッシュタグを自動生成。人間が毎回考えるよりも一貫性のあるメタデータになります。

Step 4: YouTubeアップロード — 前述のスクリプトで動画とメタデータをアップロード。安全のためすべて下書き（非公開）でアップされます。

Step 5: 確認・公開 — YouTube Studioで最終確認し公開。完全自動化もできますが、品質チェックのために人間が最終判断を下すのが須崎のポリシーです。

YouTube API自動化の5つのメリット

YouTube API自動化で得られるメリットを整理します。

YouTube API自動化の注意点

OAuth 2.0認証が必須

YouTube Data APIで動画をアップロードするには、OAuth 2.0認証が必要です。APIキーだけではアップロードやメタデータの変更はできません。Google Cloud Consoleでプロジェクト作成 → API有効化 → OAuth同意画面設定 → クライアントID作成、という手順で設定します。初回のみブラウザ認証が必要ですが、以降はトークンが保存され自動で通ります。

下書きアップロードを推奨

APIからのアップロードでは、必ず「非公開」でアップロードすることを推奨します。メタデータのミスを公開前に修正でき、サムネイルの確認もYouTube Studio上で行えます。

YouTube利用規約の遵守

スパム的な大量アップロード、著作権素材の無断使用は禁止です。自動化はあくまで正当なコンテンツを効率的に公開するための手段として、クォータの範囲内で運用しましょう。

よくある質問（FAQ）

Q. プログラミングの知識がなくてもYouTube APIは使えますか？

基本的にはPythonなどのプログラミング知識が必要です。ただし、Google公式のサンプルコードが公開されているので、それをベースにカスタマイズすれば、初心者でも始められます。最低限、Pythonの基本文法とコマンドラインの操作ができれば十分です。

Q. 無料で使えますか？

はい、YouTube Data API v3は無料で利用できます。Google Cloud Consoleでプロジェクトを作成し、APIを有効化するだけで使い始められます。ただし、1日あたりのクォータ（10,000ユニット）を超える場合は、追加のクォータ申請が必要です。

Q. APIでアップロードした動画の収益化はできますか？

はい、APIでアップロードした動画でも、通常のYouTubeパートナープログラムの条件を満たしていれば収益化は可能です。アップロード方法による制限はありません。

Q. 予約投稿は何日先まで設定できますか？

YouTube APIのpublishAtパラメータには特に日数の上限はありません。実用上は数週間〜1ヶ月先程度の予約が一般的です。あまり先の日付を設定すると、コンテンツの鮮度が落ちる可能性があるため注意してください。

まとめ

YouTube Data API v3を活用することで、動画のアップロード作業を大幅に効率化できます。手動で行っていたタイトル・説明文・タグの入力、公開設定、予約投稿などが、すべてスクリプトから自動化されます。

さらにAIと組み合わせることで、コンテンツ企画からメタデータ生成、アップロードまでを一気通貫で処理できるワークフローが構築できます。須崎の実運用では、14本のYouTube Shortsを一括アップロードし、大幅な時間短縮を実現しました。

ただし、OAuth 2.0認証の設定、クォータの管理、YouTube利用規約の遵守は必須です。下書きアップロードを基本とし、人間の目による最終チェックを欠かさないことが、安全な自動化運用のポイントです。