オープンソースライブラリで .NET C# から YouTube にファイルを出力
Google のオープンソース .NET クライアントを使い、ローカルの MP4 を YouTube チャンネルにアップロードします。このコンソールアプリはアップロード専用のアクセス権を要求し、動画を非公開に設定し、チャンネル登録者への通知を無効にして、YouTube が返した動画 ID を出力します。アップロードの受け付けと動画処理の完了は別の結果です。
前提条件
この手順では、Linux 上の Bash と同じコンピューター上のブラウザーを使用します。最新のセキュリティパッチが適用された .NET 10 SDK をインストールしてください。ローカルのサンプルは SDK 10.0.403 とランタイム 10.0.14 で確認しています。SDK にはランタイムが含まれます。ランタイムだけではプロジェクトを作成、ビルドできません。
所有しているかアップロードの許可を得ている、サイズが小さく再生可能な MP4 と、YouTube チャンネル、およびそのチャンネル ID も必要です。目的のチャンネルのメインのオーナーとしてログインした状態で、YouTube のチャンネル ID の確認手順に従ってください。ファイル名には UTF-8 を使用してください。このアプリはファイルを video/mp4 として送信します。ほかのファイルを動画に変換したり、コーデックを検証したりするものではありません。
Google のプロジェクトと OAuth のセットアップ手順に従い、Google Cloud プロジェクトで YouTube Data API v3 を有効にしてください。同意画面を設定し、アプリがテスト中の場合は Google アカウントをテストユーザーに追加してください。種類が Desktop app の OAuth クライアントを作成し、ソースリポジトリの外にある非公開の場所に JSON ファイルをダウンロードしてください。API キーではアップロードを認可できません。
Google のデスクトップ OAuth フローは、ブラウザーとローカルのコールバックリスナーを使用します。このサンプルは対話型のローカルアプリケーション向けです。リモートのヘッドレスサーバーには別の認可設計が必要です。同意時には、該当する場合はブランドアカウントも含め、目的の YouTube チャンネルを選択してください。ひとつの Google アカウントが複数のチャンネルを持つ場合があります。
YouTube API クライアントのセットアップ
既存の .NET プロジェクトの外にある、書き込み可能なフォルダーで開始してください。以下のガードは親プロジェクトの設定がある場合に処理を拒否し、継承された SDK のバージョン固定やビルド設定によって、この独立したサンプルが意図せず変わるのを防ぎます。新しい youtube-upload フォルダーを作成しますが、シェルは元のディレクトリに留まります。同名のフォルダーがすでにある場合は、それを保持してセットアップを停止します。
(
command -v dotnet >/dev/null || exit 1
parent=$(pwd -P)
while :; do
for name in global.json Directory.Build.props Directory.Build.targets Directory.Packages.props NuGet.Config nuget.config NuGet.config; do
if [ -e "$parent/$name" ]; then
printf 'Use a folder without parent .NET configuration: %s\n' "$parent/$name" >&2
exit 1
fi
done
[ "$parent" = / ] && break
parent=${parent%/*}
parent=${parent:-/}
done
dotnet --version &&
mkdir youtube-upload &&
cd youtube-upload &&
dotnet new console --framework net10.0 &&
dotnet add package Google.Apis.YouTube.v3 --version 1.78.0.4309 &&
dotnet build
)
このパッケージは Google の .NET 向け YouTube Data API クライアントです。作成、インストール、ビルドのいずれかが失敗した場合は、表示されたエラーを解決してから続けてください。作成済みのファイルは保持し、既存のプロジェクトに作成用のブロックを貼り付けないでください。
動画のアップロード
生成された youtube-upload/Program.cs を、以下の完全なプログラムに置き換えてください。ユーザーの認可を取得、保持するために、GoogleWebAuthorizationBroker と FileDataStoreを使用します。トークンディレクトリは同意時に選択したチャンネルに関連付けられます。ディレクトリ名でチャンネルを選択するわけではありません。
using Google.Apis.Auth.OAuth2;
using Google.Apis.Auth.OAuth2.Responses;
using Google.Apis.Services;
using Google.Apis.Upload;
using Google.Apis.Util.Store;
using Google.Apis.YouTube.v3;
using Google.Apis.YouTube.v3.Data;
public static class Program
{
public static async Task<int> Main(string[] args)
{
if (args.Length != 5 || string.IsNullOrWhiteSpace(args[3]) ||
string.IsNullOrWhiteSpace(args[4]) || args[4].Length > 100)
{
Console.Error.WriteLine(
"Usage: client.json video.mp4 token-directory expected-channel-id title");
return 2;
}
if (!File.Exists(args[0]) || !File.Exists(args[1]))
{
Console.Error.WriteLine("OAuth client file or video is missing. No upload started.");
return 2;
}
try
{
using var clientFile = File.OpenRead(args[0]);
using var videoFile = File.OpenRead(args[1]);
using var deadline = new CancellationTokenSource(TimeSpan.FromMinutes(10));
var store = new FileDataStore(Path.GetFullPath(args[2]), true);
var cached = await store.GetAsync<TokenResponse>("channel-owner");
Console.Error.WriteLine(cached is null
? "Opening browser authorization. Select the intended YouTube channel."
: "Using saved authorization; no new channel selection was requested.");
var credential = await GoogleWebAuthorizationBroker.AuthorizeAsync(
GoogleClientSecrets.FromStream(clientFile).Secrets,
new[] { YouTubeService.Scope.YoutubeUpload },
"channel-owner", deadline.Token, store);
var scopes = credential.Token.Scope?.Split(' ', StringSplitOptions.RemoveEmptyEntries);
if (scopes is null || scopes.Length != 1 ||
scopes[0] != YouTubeService.Scope.YoutubeUpload)
{
Console.Error.WriteLine("Expected upload-only consent. Use a fresh token directory.");
return 1;
}
using var youtube = new YouTubeService(new BaseClientService.Initializer
{
HttpClientInitializer = credential,
ApplicationName = "PrivateVideoUpload"
});
youtube.HttpClient.Timeout = TimeSpan.FromSeconds(60);
await UploadPrivateVideoAsync(youtube, videoFile, args[3], args[4], deadline.Token);
Console.WriteLine("Private upload accepted; processing may still be pending.");
return 0;
}
catch (Exception)
{
Console.Error.WriteLine(
"Upload failed or its outcome is unknown. Inspect the selected channel in " +
"YouTube Studio before retrying. Do not automatically repeat this upload.");
return 1;
}
}
public static async Task<string> UploadPrivateVideoAsync(
YouTubeService youtube, Stream source, string expectedChannelId,
string title, CancellationToken cancellationToken)
{
var video = new Video
{
Snippet = new VideoSnippet { Title = title, CategoryId = "22" },
Status = new VideoStatus { PrivacyStatus = "private" }
};
var upload = youtube.Videos.Insert(video, "snippet,status", source, "video/mp4");
upload.NotifySubscribers = false;
Console.Error.WriteLine($"Upload settings: privacy={video.Status.PrivacyStatus}; notifySubscribers={upload.NotifySubscribers}");
upload.ChunkSize = ResumableUpload.MinimumChunkSize;
upload.ProgressChanged += progress =>
{
if (progress.Status == UploadStatus.Uploading)
Console.Error.WriteLine($"Bytes sent: {progress.BytesSent}");
};
var progress = await upload.UploadAsync(cancellationToken);
progress.ThrowOnFailure();
var result = upload.ResponseBody;
if (progress.Status != UploadStatus.Completed || string.IsNullOrWhiteSpace(result?.Id))
throw new InvalidOperationException("No confirmed video ID was returned.");
Console.WriteLine($"Video ID: {result.Id}");
if (result.Snippet?.ChannelId != expectedChannelId || result.Snippet?.Title != title ||
result.Status?.PrivacyStatus != "private")
throw new InvalidOperationException("Returned video metadata did not match the upload.");
return result.Id;
}
}
元の作業フォルダーから、引数を五つすべて置き換えて以下のコマンドを実行してください。初回の認可では、未使用の非公開トークンディレクトリのパスを選んでください。このコマンドは保存済みのプログラムをビルドしてから実行します。-- はアプリケーションの引数と .NET のオプションを区切ります。
dotnet run --project ./youtube-upload -- \
"/absolute/path/client.json" "/absolute/path/my video.mp4" \
"/absolute/private/path/youtube-channel-tokens" \
"YOUR_CHANNEL_ID" "My private upload"
ブラウザーで Google の同意フローを完了してください。プログラムが要求するのは youtube.upload のみです。これは videos.insertが受け入れるスコープのひとつです。プログラムは privacyStatus=private と notifySubscribers=false を明示的に送信します。後者を指定しない場合、デフォルトは true です。
アップロードが受け付けられると、プログラムは Video ID: に続けて実際の ID を出力します。その ID を保存し、選択したチャンネルの YouTube Studio で動画を確認してください。期待するチャンネル ID の引数は、アップロードの後に返されたメタデータを確認するためのものです。アップロード先を選択したり、誤って認可したチャンネルへのアップロードを防いだりするものではありません。確認に失敗した場合、プログラムは失敗として終了しますが、動画を見つけられるように返された ID を出力します。
送信済みバイト数は転送の進捗を表します。アップロードが完了して ID が返されても、YouTube が再生可能な動画の処理を完了した証拠にはなりません。公開前に YouTube Studio で処理状況を確認してください。Google はこの段階について、別の processingDetails.processingStatusを説明しています。
クォータとレート制限への対応
アップロードを自動化する前に、Google Cloud と
YouTube クォータ計算ツールでプロジェクトの現在の上限を確認してください。2026年11月5日時点で、ドキュメントに記載されたデフォルトは、videos.insert の呼び出しが 1日100回の独立したバケットです。検索とその他のエンドポイントには、それぞれ別の上限があります。日次クォータは太平洋時間の午前 0 時にリセットされます。無効なリクエストもクォータを消費します。
ローカルのカウンターでは、ほかのプロセス、再起動、SDK のすべてのリクエストを把握できません。このサンプルはアプリケーションレベルで挿入を一度試みます。プロジェクト全体のクォータスケジューラーは実装していません。
再試行する前に失敗に対処する
終了コードがゼロ以外の場合、拒否、キャンセル、タイムアウト、または YouTube が動画を受け付けた後の応答の喪失が考えられます。アプリは認可とアップロードのキャンセルを 10 分後に要求し、アップロードリクエストごとに 60秒の HTTP タイムアウトを設定します。キャンセルは協調的に処理され、プロセスの終了を保証するものではありません。接続が遅いと、正常なアップロードでも中断される場合があります。どちらのタイムアウトも、リモートへの書き込みがロールバックされた証拠にはなりません。
SDK は再開可能なアップロードリクエストを使用しますが、このプログラムはプロセス終了後の復旧に備えてセッション URI を保存しません。dotnet run コマンド全体を再試行ループで囲まないでください。最初の応答が失われた場合、新しい videos.insert によって、ふたつ目の動画が作成される可能性があります。再試行するか判断する前に、目的のチャンネルと、出力された動画 ID があればその ID を確認してください。進捗出力だけでは、不明な結果を確定できません。
認可とチャンネルの関連付けの維持
FileDataStore はトークンを永続化しますが、暗号化された認証情報保管庫ではありません。クライアント JSON とトークンディレクトリへのアクセスを制限し、両方をソース管理の対象外にしてください。ディレクトリを再利用するとブラウザーを省略できる場合があるため、キャッシュを使った実行が成功しても、新たにチャンネルを選択した証拠にはなりません。別のチャンネルを認可するには、別の未使用の非公開トークンディレクトリのパスを選び、同意フローを再度完了してください。
これで、一度のアップロードを行い、確認済みの結果として非公開の動画 ID を返す、コンソールのエントリーポイントができました。YouTube Studio でチャンネル、内容、処理結果を確認するまでは、動画を非公開のままにしてください。このサンプル以外で利用できるリクエストフィールドについては、公式のアップロードリファレンスを参照してください。
ご自身での運用は避けたいですか?
Transloadit は、単一の API 呼び出し内の処理の一環として、S3、Azure、Google Cloud などにファイルをエクスポートします。
