LoginSignup
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Day 9

やさしいアドベントカレンダー Advent Calendar 2025

@ryuhat

Node.jsでYouTube動画を自動アップロードする実装ガイド

Posted at

はじめに

動画コンテンツの自動投稿システムを構築する際、YouTube Data API v3は欠かせないツールです。手動アップロードの手間を省き、定期的な投稿やバッチ処理を実現できます。

本記事では、Node.jsを使ってYouTube動画をプログラマティックにアップロードする方法を、実装のポイントを押さえながら解説します。公式サンプルや日本語ブログを参考にしつつ、実際に動くシステムを構築するための要点をまとめました。

前提条件と準備

1. Google Cloud Consoleでの設定

最初に必要なのは、Google Cloud ConsoleでのAPI有効化とOAuth認証情報の取得です。

  • Google Cloud Consoleで新規プロジェクトを作成
  • YouTube Data API v3を有効化
  • OAuth 2.0クライアントID（デスクトップアプリケーション）を作成
  • credentials.jsonをダウンロード

このcredentials.jsonには、クライアントIDとシークレットが含まれており、OAuth認証フローの起点となります。

2. 必要なパッケージのインストール

npm install googleapis

Googleの公式Node.jsクライアントライブラリgoogleapis一つで、YouTube APIを含むすべてのGoogle APIにアクセスできます。

認証フローの実装

OAuth 2.0トークンの取得

YouTube APIを使うには、ユーザーの許可が必要です。初回実行時のみ、ブラウザで認証URLを開いてアクセストークンを取得し、token.jsonとして保存します。

auth.jsの役割

多くの実装例では、認証ロジックをauth.jsとして分離しています。

主な処理の流れ:

  1. credentials.jsonを読み込んでOAuth2クライアントを初期化
  2. token.jsonが存在する場合は読み込んで再利用
  3. 存在しない場合は認証URLを生成してブラウザで開く
  4. ユーザーが許可すると認証コードが得られる
  5. そのコードを使ってアクセストークンとリフレッシュトークンを取得
  6. token.jsonに保存して次回以降の認証をスキップ

この仕組みにより、2回目以降の実行では自動的に認証済みの状態でAPIを叩けます。リフレッシュトークンがあれば、アクセストークンの期限が切れても自動更新されます。

セキュリティ上の注意点

credentials.jsonとtoken.jsonは絶対にGitにコミットしないでください。.gitignoreに必ず追加し、本番環境では環境変数や秘密管理システムで扱うべきです。

動画アップロードの実装

upload.jsの基本構造

認証が完了したら、実際のアップロード処理を実装します。

videos.insertメソッドのパラメータ

YouTube APIのvideos.insertメソッドには、大きく分けて3つの要素を渡します。

1. part（必須）

レスポンスに含めたいリソースパーツを指定します。

part: 'id,snippet,status'
  • snippet: タイトル、説明文、タグなどのメタデータ
  • status: 公開設定
  • id: 動画ID（レスポンスで取得）

2. requestBody

動画のメタデータを定義します。

requestBody: {
  snippet: {
    title: '動画タイトル',
    description: '説明文',
    tags: ['タグ1', 'タグ2'],
    categoryId: '20'  // ゲームカテゴリ
  },
  status: {
    privacyStatus: 'public',  // public, unlisted, private
    selfDeclaredMadeForKids: false
  }
}

categoryIdはジャンルを示す数値で、例えば：

  • 10: 音楽
  • 20: ゲーム
  • 22: ブログ
  • 28: 科学技術

privacyStatusで公開範囲を制御できます。テストではunlistedやprivateを使い、本番ではpublicにするのが安全です。

3. media.body

実際の動画ファイルをストリームで渡します。

media: {
  body: fs.createReadStream('path/to/video.mp4')
}

createReadStreamを使うことで、大きな動画ファイルでもメモリを圧迫せずにアップロードできます。

アップロード進捗の表示

公式サンプルでは、onUploadProgressコールバックで進捗をパーセント表示する実装が紹介されています。

onUploadProgress: evt => {
  const progress = (evt.bytesRead / fileSize) * 100;
  console.log(`${Math.round(progress)}% complete`);
}

これにより、ユーザーに現在の状況をフィードバックでき、長時間のアップロードでも安心感を与えられます。

実装パターンと応用例

1. 単一ファイルのアップロード

最もシンプルなユースケースです。特定の1ファイルを指定してアップロードします。

適用場面:

  • 手動で選んだ動画の投稿
  • テスト環境での動作確認
  • ワンショットのバックアップ

2. フォルダ内の一括アップロード

fs.readdir()でフォルダ内のファイルを取得し、ループ処理で連続アップロードします。

実装のポイント:

  • 非同期処理の制御（Promise.allやasync/awaitの活用）
  • APIレート制限への配慮（1日あたりのクォータ）
  • エラーハンドリング（一部失敗しても全体を止めない）

3. 定期実行とスケジューリング

cronやNode-cronを使って、特定の時間に自動アップロードするシステムを構築できます。

ユースケース:

  • 毎朝9時に昨日撮影した動画を投稿
  • 週末にまとめて編集した動画を平日に分散投稿
  • イベント時の定時配信

4. YouTube Shortsへの対応

Shortsも通常の動画アップロードと同じvideos.insertで処理できます。

Shortsとして認識させるコツ:

  • 動画の長さを60秒以内に
  • アスペクト比を9:16（縦型）に
  • タイトルや説明文に#Shortsを含める

これだけで、YouTubeが自動的にShorts扱いしてくれます。API側で特別な設定は不要です。

エラーハンドリングと実運用

よくあるエラーと対処法

1. 認証エラー（401 Unauthorized）

  • token.jsonが破損している場合は削除して再認証
  • スコープが不足している場合はcredentials.jsonを再作成

2. クォータ超過（403 Forbidden）

  • YouTube Data APIには1日あたりのクォータ制限がある
  • デフォルトは10,000ユニット/日で、動画アップロードは1回1,600ユニット消費
  • つまり1日6本程度が上限（クォータ増加リクエストは可能）

3. ファイル形式エラー

  • サポートされている形式: MP4, MOV, AVI, FLV, WMVなど
  • コーデックが非対応の場合はffmpegで事前変換

ログとモニタリング

本番運用では、以下の情報をログに残すことを推奨します。

  • アップロード開始・完了時刻
  • 動画ファイル名とサイズ
  • 取得した動画ID
  • エラー発生時の詳細情報

これにより、問題発生時のトラブルシューティングが容易になります。

パフォーマンスの最適化

ファイルサイズの事前確認

fs.stat()でファイルサイズを取得し、大きすぎる場合は圧縮や分割を検討します。YouTubeの上限は256GBまたは12時間ですが、実用上は数GB以内に抑えるのが無難です。

並列アップロードの制御

複数ファイルを同時にアップロードする場合、並列数を制限してAPIレート制限を回避します。p-limitなどのライブラリで同時実行数を2〜3本に制限するのが効果的です。

セキュリティのベストプラクティス

1. 認証情報の管理

  • 本番環境では環境変数で管理
  • AWS Secrets ManagerやGoogle Secret Managerの活用
  • コンテナ化する場合はKubernetesのSecretsを利用

2. スコープの最小化

OAuth2のスコープは必要最小限に。動画アップロードだけならhttps://www.googleapis.com/auth/youtube.uploadのみで十分です。

3. トークンの定期的なローテーション

長期運用する場合、定期的に認証をやり直してトークンを更新することで、セキュリティリスクを低減できます。

まとめ

Node.jsとYouTube Data API v3を使った動画アップロードは、認証さえ理解すれば比較的シンプルに実装できます。

実装の流れをおさらい:

  1. Google Cloud Consoleでクレデンシャルを取得
  2. OAuth2フローで認証してトークンを保存
  3. videos.insertでメタデータとファイルストリームを送信
  4. 進捗表示やエラーハンドリングで堅牢性を高める

単純な1ファイルアップロードから始めて、徐々にバッチ処理や定期実行に発展させていくのが現実的なアプローチです。APIクォータとエラーハンドリングに注意を払えば、安定した自動投稿システムを構築できます。

公式ドキュメントと日本語ブログ記事を組み合わせることで、必要な情報はほぼすべて揃います。あとは実際にコードを書いて試行錯誤しながら、自分のユースケースに最適化していくだけです。

参考リソース

実装で困ったら、公式サンプルコードをベースに少しずつカスタマイズしていくのが確実です。

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
Sign upLogin
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?