YouTube Data API v3の概要
YouTube Data API v3は、YouTubeのコンテンツ・チャンネル・プレイリスト・コメントへのプログラムによるアクセスを提供するAPIです。自社サイトへのYouTube動画の埋め込みから、チャンネル管理の自動化・コンテンツ分析まで幅広い用途に活用されています。
APIキーの取得とセットアップ
- Google Cloud Consoleでプロジェクトを作成
- YouTube Data API v3を有効化
- APIキーを作成（読み取り専用の場合）またはOAuth 2.0クライアントを設定
- APIキーの制限設定（HTTPリファラー・IPアドレス）
動画の検索
GET https://www.googleapis.com/youtube/v3/search
?part=snippet
&q=プログラミング入門
&type=video
&order=viewCount
&maxResults=10
®ionCode=JP
&relevanceLanguage=ja
&key=YOUR_API_KEY検索APIはクォータ消費が多い（100クォータ/リクエスト）ため、結果のキャッシュを積極的に活用します。
動画の詳細情報取得
GET https://www.googleapis.com/youtube/v3/videos
?part=snippet,statistics,contentDetails
&id=VIDEO_ID1,VIDEO_ID2
&key=YOUR_API_KEYsnippetには動画タイトル・説明・サムネイル・公開日、statisticsには視聴回数・いいね数・コメント数、contentDetailsには動画時間・画質情報が含まれます。
チャンネル情報の取得
チャンネルIDまたはユーザー名からチャンネル情報を取得できます。登録者数・総視聴回数・アップロード動画数などの統計情報も取得可能です。
コメントの管理
動画のコメント一覧取得・返信・コメントの削除・スパム報告などをAPIで操作できます。コメントの取得はOAuth 2.0なしでも可能ですが、投稿・削除にはユーザー認証が必要です。
動画のアップロード
YouTube Data APIを使って動画をプログラムからアップロードできます。タイトル・説明・タグ・カテゴリー・公開設定などのメタデータを指定します。大きなファイルはリジュームアップロード（Resumable Upload）で安全に転送します。OAuth 2.0でユーザー認証が必要です。
クォータ管理のベストプラクティス
- 結果のキャッシュ（Redis等）で同じリクエストの繰り返しを避ける
- partパラメーターで必要なフィールドのみ取得する（不要なpartを指定しない）
- Search APIは消費クォータが多いため頻繁な呼び出しを避ける
- Google Cloud ConsoleのAPIダッシュボードで使用量を監視
- クォータ超過を見越して追加クォータを申請（Googleへの申請が必要）
活用例
- コンテンツポータル：特定チャンネルの最新動画を自社サイトに表示
- 動画分析ダッシュボード：自社チャンネルのパフォーマンスを可視化
- コンテンツ管理：大量の動画のタイトル・説明を一括更新
- コメントモデレーション：スパムコメントの自動検知・削除
まとめ
YouTube Data API v3は動画コンテンツの検索・管理・分析に必要な機能を提供します。クォータ制限への対処が最大の課題で、キャッシュと効率的なAPIリクエスト設計が重要です。動画埋め込みだけであればiframe Embed APIで十分ですが、チャンネル管理・詳細分析にはData APIが必要です。