開発

YouTube Data API v3の使い方:新クォータ制とAPIキー・OAuth、Python実装

YouTube Data API v3の使い方:新クォータ制とAPIキー・OAuth、Python実装

YouTube Data API v3は、動画の情報や再生回数の取得、チャンネルへの動画アップロードをプログラムから行うためのGoogle公式APIです。2026年6月1日に検索とアップロードのクォータが1日100回の別枠へ切り出され、11月2日には未審査プロジェクトからのアップロードを非公開に限る制限が撤回されました。この記事では2026年11月16日時点の公式ドキュメントをもとに、APIキーとOAuthの使い分け、検索を使わずに動画一覧を取るPythonコード、動画アップロードの実装、取得データの保存規約、採用を見送る場面までを扱います。

まとめ:YouTube Data APIで最初に決める認証方式とクォータ配分

公開動画の情報を読むだけならAPIキー、特定チャンネルの動画を投稿・更新するならOAuth 2.0です。クォータは通常のメソッド合計で1日1万ユニット、search.listとvideos.insertはそれぞれ別枠で1日100回です。キーワード検索を多用する設計はすぐ上限に当たるため、自社チャンネルの動画一覧は検索ではなくアップロード済みプレイリストから取ります。

APIで取得した統計値は30日を超えて保存できず、アップロード時にprivacyStatusを省くと公開で投稿されます。限定した相手にだけ視聴させたい、視聴ログを自社で握りたいといった要件があるなら、YouTubeではなく自社の動画配信基盤を検討します。

YouTube Data API v3でできることとAPIキー・OAuthの使い分け

同じAPIでも、公開データを読む処理と、チャンネル所有者の権限で書き込む処理とで認証方式が変わります。

公開動画の取得はAPIキー、自分のチャンネル操作はOAuthの区分

公式の概要ページは、ユーザーの認可が要るメソッドを使う場合にだけOAuth 2.0を実装するよう案内しています。業務でよく使う処理を認証方式で分けると次のとおりです。

処理 主なメソッド 認証
公開動画のタイトル・再生回数を取得 videos.list APIキー
チャンネルの動画一覧を取得 チャンネル・プレイリスト項目の取得 APIキー
キーワードで動画を検索 search.list APIキー
動画のアップロード videos.insert OAuth 2.0
タイトル・説明文の更新 videos.update OAuth 2.0
限定公開・非公開動画の取得 videos.list(所有者として) OAuth 2.0

表のチャンネル・プレイリスト項目の取得には、channels.listとplaylistItems.listを使います。コーポレートサイトに自社チャンネルの新着動画を並べる程度なら、APIキーだけで完結します。OAuthが要るのは、システムがチャンネル所有者の代わりに操作する場面です。

youtube.readonlyとyoutube.uploadのOAuthスコープ4種

認可の実装ガイドに並ぶスコープのうち、通常使うのは次の4つです。必要な操作だけを許可するスコープを選ぶと、同意画面で利用者に示す権限も小さくなります。

  • youtube.readonly:自分のアカウントの閲覧だけ。非公開動画の一覧取得など
  • youtube.upload:動画の管理。アップロードだけを行うシステムはこれで足ります
  • youtube:YouTubeアカウントの管理全般
  • youtube.force-ssl:動画・評価・コメント・字幕の閲覧と編集、完全な削除まで

テレビや組込み機器向けのデバイスフローはyoutubeとyoutube.readonlyなどに限られ、youtube.force-sslは使えません。OAuthの認可コードやリフレッシュトークンの仕組みはOAuth 2.0の仕組みと認可フローで整理しています。

2026年6月から変わったクォータ:検索とアップロードの別枠管理

2026年11月時点のクォータ計算ページ(2026年11月12日更新)は、既存の解説記事とは違う数字を示しています。

1日1万ユニットと別枠100回で数える2026年11月時点のメソッド別コスト

新規プロジェクトの既定値は、search.listが1日100回、videos.insertが1日100回、それ以外の全メソッド合計で1日1万ユニットです。別枠の2つは1回の呼び出しで1を消費します。

処理・メソッド 消費 数える枠
動画・チャンネル・プレイリスト項目の取得 1 1日1万ユニット
動画更新・リスト項目追加・サムネイル設定 50 1日1万ユニット
captions.insert 400 1日1万ユニット
search.list 1回 別枠・1日100回
videos.insert 1回 別枠・1日100回

表の取得メソッドはvideos.list、channels.list、playlistItems.listです。動画更新はvideos.update、リスト項目追加はplaylistItems.insert、サムネイル設定はthumbnails.setに対応します。

無効なリクエストも最低1ユニットを消費します。日次の枠は太平洋時間の0時に戻るため、日本時間では冬時間の期間が17時、夏時間の期間が16時です。夕方に集計バッチを流す設計なら、リセットの前後どちらで実行するかを決めておきます。

検索100ユニット・アップロード約1,600ユニットという旧来の数字が古い理由

公式の改定履歴によると、2025年12月4日に動画アップロードの消費が約1,600ユニットから約100ユニットへ下がりました。続く2026年6月1日、YouTubeはメソッド単位の細かいクォータへの移行を始め、最初にvideos.insertとsearch.listを独立した枠に切り出しています。

旧来の説明では、1万ユニットを検索100ユニットで割って「1日100回まで」としていました。回数の上限は結果的に同じでも、検索を使い切ってもvideos.listなど他のメソッドが止まらない点が違います。逆に、検索以外の処理でユニットを浪費しても検索の100回は減りません。2026年6月3日に追加された統計一括取得用のvideos.batchGetStatsも、独自の枠(1日1万ユニット)で数えます。

quotaExceededとuploadLimitExceededの上限超過エラー

エラー一覧には、似た名前の上限エラーが2つあります。quotaExceeded(403)はGoogle Cloudプロジェクトのクォータ超過です。uploadLimitExceeded(400)はチャンネル側の1日のアップロード上限で、プロジェクトのクォータとは別の制限だと明記されています。

前者はリセット時刻まで待つかクォータ拡張を申請し、後者はチャンネル側の制限なので翌日に再試行します。両者を同じリトライ処理に流すと、原因の切り分けを誤ります。

Google Cloudでプロジェクト作成からAPIキー発行までの準備手順

コードを書く前に、Google Cloudコンソール側で次の順に設定します。

APIの有効化とAPIキー・OAuthクライアントIDを用意する4工程

  1. Google Cloudコンソールでプロジェクトを作成する
  2. APIライブラリで「YouTube Data API v3」を有効にする
  3. 公開データを読むなら「認証情報」でAPIキーを作成し、API制限でYouTube Data API v3だけを許可する
  4. アップロードするなら、OAuth同意画面を設定したうえでOAuthクライアントID(デスクトップアプリ)を作り、client_secret.jsonをダウンロードする

YouTube Data API自体に従量課金は無く、クォータの範囲で使う限り請求は発生しません。それでもAPIキーが漏れると第三者にクォータを食われ、自社の処理が止まります。キーにはサーバーのIPアドレスなどのアプリケーション制限も掛けます。ブラウザ用とサーバー用でキーを分ける考え方はGoogle Maps APIのAPIキー制限の設定と共通です。

curlでvideos.listを呼んでAPIキーの動作を確かめる最初の1回

キーを作ったら、プログラムを書く前にcurlで1回呼んで疎通を確かめます。消費は1ユニットです。

curl -s "https://www.googleapis.com/youtube/v3/videos?part=snippet,statistics&id=動画ID&key=${YOUTUBE_API_KEY}"

応答のitemsが空なら動画IDの誤り、error.errors[0].reasonがforbiddenならAPIの有効化漏れかキーの制限設定を疑います。partは必須で、指定した部分だけが返ります。

Pythonで自社チャンネルの動画一覧と再生回数を取得するコード

ここでは公式のPythonクライアントを使います。google-api-python-clientは2026年11月16日時点の最新版が2.202.0(2026年11月10日公開・Python 3.10以上)です。READMEは新機能を追加しない保守モードと明記していますが、YouTube Data APIの公式サンプルはこのライブラリで書かれています。

search.listを使わずアップロード済みプレイリストから全件を取る実装

自社チャンネルの動画をサイトに並べる用途でsearch.listを使うと、1日100回の枠をすぐに使い切ります。channels.listのforHandleでチャンネルを引き、contentDetails.relatedPlaylists.uploadsのプレイリストをplaylistItems.listで1ページ50件ずつたどれば、すべて通常枠の1ユニットで済みます。

pip install google-api-python-client google-auth-oauthlib
import os
from googleapiclient.discovery import build

youtube = build("youtube", "v3", developerKey=os.environ["YOUTUBE_API_KEY"])

# 1. ハンドルからチャンネルを引き、アップロード済み動画のプレイリストIDを取る(1ユニット)
ch = youtube.channels().list(part="contentDetails", forHandle="@GoogleDevelopers").execute()
uploads = ch["items"][0]["contentDetails"]["relatedPlaylists"]["uploads"]

# 2. プレイリストを50件ずつたどって動画IDを集める(1ページ1ユニット)
video_ids, token = [], None
while True:
    res = youtube.playlistItems().list(
        part="contentDetails", playlistId=uploads, maxResults=50, pageToken=token
    ).execute()
    video_ids += [it["contentDetails"]["videoId"] for it in res["items"]]
    token = res.get("nextPageToken")
    if not token:
        break

# 3. 動画IDを50件ずつまとめてタイトルと再生回数を取る(1回1ユニット)
for i in range(0, len(video_ids), 50):
    res = youtube.videos().list(
        part="snippet,statistics", id=",".join(video_ids[i:i + 50])
    ).execute()
    for v in res["items"]:
        print(v["id"], v["snippet"]["title"], v["statistics"].get("viewCount"))

動画が500本のチャンネルなら、チャンネル取得1、プレイリスト10ページで10、統計取得10回で10の計21ユニットです。1日1万ユニットに対して、毎時更新しても余裕があります。

キーワード検索は1日100回の枠を前提に結果を共有して使う設計

サイト内に「YouTubeから関連動画を探す」検索窓を置く場合、利用者の入力ごとにsearch.listを呼ぶと、1日100回で機能が止まります。maxResultsの上限は50件で、次ページを取るたびにもう1回消費する点にも注意が要ります。

実務では、検索語を管理者があらかじめ決めておき、バッチで1日数回だけ検索して結果を共有する形に変えます。利用者ごとに自由な検索をさせたいなら、YouTubeの埋め込みプレイヤーや検索画面へ誘導し、APIでの検索は使いません。

OAuth 2.0で動画をアップロードするPythonコードと公開設定の注意点

videos.insertは最大256GBまでの動画ファイルを受け付け、中断しても途中から再開できるresumableアップロードに対応しています。

InstalledAppFlowで認可しresumableで分割送信するアップロード処理

公式のアップロードガイドのサンプルを、必要な部分に絞って書き直しました。初回はブラウザが開き、チャンネル所有者のGoogleアカウントで同意します。

from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.http import MediaFileUpload

SCOPES = ["https://www.googleapis.com/auth/youtube.upload"]
flow = InstalledAppFlow.from_client_secrets_file("client_secret.json", SCOPES)
creds = flow.run_local_server(port=0)
youtube = build("youtube", "v3", credentials=creds)

body = {
    "snippet": {"title": "製品紹介 2026年版", "description": "社内確認用", "categoryId": "22"},
    "status": {"privacyStatus": "private"},  # 省略すると公開で投稿される
}
# chunksize は256KBの倍数。回線が不安定な環境では小さく区切る
media = MediaFileUpload("intro.mp4", mimetype="video/*",
                        chunksize=8 * 1024 * 1024, resumable=True)
request = youtube.videos().insert(part="snippet,status", body=body, media_body=media)

response = None
while response is None:
    status, response = request.next_chunk()
    if status:
        print(f"{int(status.progress() * 100)}%")
print("uploaded:", response["id"])

サーバーで定期的に投稿するなら、初回に得たリフレッシュトークンを安全な保管先に置き、2回目以降は同意画面を出さずにアクセストークンを更新します。認可を取り消された場合に備え、トークン更新の失敗を検知して担当者へ通知する処理も入れておきます。

2026年11月に撤回された未審査プロジェクトの非公開制限と既定値

2020年7月28日以降に作られた未審査のAPIプロジェクトは、アップロードした動画が非公開に固定され、監査を通るまで公開できませんでした。改定履歴によると、この制限は2026年11月2日に撤回されています。

代わりに注意が要るのは既定値です。status.privacyStatusを省くと動画は公開で投稿されます(チャンネル設定によっては非公開になる例外あり)。社内確認前の動画がそのまま公開される事故を防ぐため、コードでは必ずprivateかunlistedを明示し、公開は人の操作に残します。開発者ポリシーも、利用者の明示的な同意なしにアプリが動画の公開設定を変えることを禁じています。

取得データの30日保存規約に沿う運用設計とクォータ拡張審査の要件

技術的に取れるデータでも、保存や表示の仕方はYouTube API Servicesの開発者ポリシーに縛られます。設計段階で確認しないと、作り直しになる項目です。

再生回数や登録者数を30日を超えて保存しないデータベース設計

ポリシーは、認可なしで取得した統計値(他チャンネルの登録者数など)を30日を超えて保存してはならないと定めています。OAuthで認可を受けたデータは30日を超えて保存できますが、30日ごとに認可が取り消されていないか、動画が削除されていないかを確認する義務があります。

競合チャンネルの再生回数を毎日記録して長期の推移グラフを作る、といった設計はこの規定に抵触する設計です。統計テーブルには取得日時の列を持たせ、30日を過ぎた行を日次バッチで削除するか、再取得して上書きします。YouTubeの動画本体をダウンロードして保存することも、事前の書面承認なしには禁じられています。

API Compliance Auditによるクォータ拡張と90日放置での停止

既定のクォータで足りない場合は、API Compliance Auditを受けてクォータ拡張を申請します。申請時に用途を示す必要があり、承認された用途以外に増えた枠を使うことはできません。用途が変われば再審査です。

見落としやすいのは休眠の扱いです。ポリシーは、90日続けて使われていないAPIプロジェクトについて、認証情報の失効やクォータの削減があり得るとしています。年に数回しか動かないバッチなら、止まったときに気づける監視を入れておきます。

YouTube Data APIで足りる案件と自社動画配信を作るべき案件の判断

YouTube Data APIは、YouTubeに置いた動画を自社のシステムから扱うための道具です。動画の置き場所そのものをYouTubeにしてよいかは、別に判断します。

動画一覧の自動掲載や投稿の自動化はYouTube Data APIで十分な理由

コーポレートサイトや採用サイトへの新着動画の自動掲載、社内システムで作った動画の定期投稿、自社チャンネルの再生回数の日次レポートは、YouTube Data APIで十分に作れます。配信インフラと視聴者の集客をYouTubeに任せられ、APIの利用料もかかりません。上で示した一覧取得のコードなら、1日の消費は数十〜数百ユニットに収まります。

限定配信・視聴制御・視聴ログが要件なら自社配信基盤を選ぶ判断

YouTubeを置き場所にすると決められないことがあります。視聴できる相手を社員や会員に限る認証、受講完了の判定に使う視聴ログ、動画ごとの課金、ダウンロード防止のDRMです。限定公開のURLは知っている人なら誰でも見られるため、会員限定コンテンツの代わりにはなりません。

研修動画や有料講座のように「誰が・どこまで見たか」が要件に入るなら、YouTube Data APIの工夫では埋まらないので採用しません。トランスコードからHLS配信までの構成は動画配信システムの構築手順、費用感は視聴時間から逆算する動画配信システムの費用で比べられます。自社基盤での開発を外部に任せる場合は、動画配信システム開発のサービスページで対応範囲を確認できます。

よくある質問

YouTube Data APIを使い始める前によく出る疑問に答えます。

YouTube Data APIは無料で使えますか?

無料です。Google Cloudのプロジェクトは必要ですが、YouTube Data APIの呼び出しに従量課金はありません。代わりにクォータで利用量が制限され、既定では通常メソッド合計で1日1万ユニット、検索とアップロードがそれぞれ1日100回です。上限を超えると翌日のリセットまでエラーが返ります。足りない場合は有料プランではなく、API Compliance Auditを通じてクォータ拡張を申請します。

APIキーだけで動画をアップロードできますか?

できません。videos.insertはOAuth 2.0による認可が必須で、youtube.uploadなどのスコープに対してチャンネル所有者が同意する必要があります。APIキーで扱えるのは公開データの読み取りです。サーバーから自動投稿する場合も、初回だけ所有者がブラウザで同意し、得たリフレッシュトークンで以降の認可を更新する形になります。

クォータの1日1万ユニットは何時にリセットされますか?

太平洋時間の0時です。日本時間に直すと、米国の冬時間の期間は17時、夏時間の期間は16時になります。検索とアップロードの別枠もリセットは同じ時刻です。使用量はGoogle Cloudコンソールの「割り当て」画面で確認でき、上限に近づいたら通知する設定を入れておくと、業務時間中に突然止まる事態を避けられます。

YouTube Data API v2や古いサンプルコードはまだ使えますか?

現在の公式ドキュメントが対象とするのはv3で、新規開発もv3で組みます。注意が要るのは、v3向けでも数年前のブログ記事のサンプルです。検索1回100ユニット、アップロード約1,600ユニットという旧来のクォータ計算や、未審査プロジェクトの動画は非公開になるという説明は、2025年12月以降の改定で実態と合わなくなりました。数値は公式のクォータ計算ページで確かめてください。

再生回数や登録者数をデータベースに蓄積して分析できますか?

自社チャンネルについてOAuthで認可を受けていれば、30日ごとに認可と動画の存在を確認する条件付きで長期保存できます。他社チャンネルの統計値は、認可なしで取得したデータとして30日を超えて保存できません。より詳しい視聴分析が目的なら、チャンネル所有者向けのYouTube Analytics APIを使う設計も検討の対象です。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.13 テックブログ 宝くじ公式サイト不正アクセス:4,436名の対象確認とパスワード再設定、変更された仕組み
  2. 2026.11.14 テックブログ Gitの脆弱性6件:CVE-2026-111760の再帰クローン対策と2.56.1への更新手順
  3. 2026.11.14 テックブログ ImageMagickの脆弱性VU#580079:policy.xmlの許可リスト設定と影響判定の手順
  4. 2026.11.14 テックブログ Check Point脆弱性CVE-2026-123039:Gaiaのroot権限昇格を確かめるコマンドと侵害調査の手順
  5. 2026.11.13 テックブログ KARTEの不正アクセス:JINS約1,829万件など利用企業の漏えい一覧と、タグ・配信・データ連携を確かめる手順【11月17日時点】

RELATED POSTS 関連記事

目次