Exportar ao YouTube em .NET C# com bibliotecas de código aberto
Use o cliente .NET de código aberto do Google para fazer upload de um MP4 local para seu canal no YouTube. Este app de console solicita acesso apenas para upload, define o vídeo como privado, desativa as notificações aos inscritos e imprime o ID do vídeo retornado pelo YouTube. A aceitação do upload e a conclusão do processamento do vídeo são resultados distintos.
Pré-requisitos
Este guia usa Bash no Linux e um navegador no mesmo computador. Instale o SDK do .NET 10 com um patch de segurança atual. O exemplo local foi verificado com o SDK 10.0.403 e o runtime 10.0.14. O SDK inclui o runtime; o runtime sozinho não consegue criar nem compilar um projeto.
Você também precisa de um MP4 pequeno e reproduzível que seja seu ou que você tenha permissão
para enviar, de um canal no YouTube e do ID desse canal. Siga as
instruções sobre o ID do canal enquanto estiver conectado como
proprietário principal do canal desejado. Use nomes de arquivo em UTF-8. Este app envia o arquivo
como video/mp4; ele não converte outros arquivos em vídeo nem valida seus codecs.
Siga a configuração de projeto e OAuth do Google para ativar a YouTube Data API v3 em um projeto do Google Cloud. Configure a tela de consentimento e adicione sua conta do Google como usuário de teste quando o app estiver em teste. Crie um cliente OAuth do tipo Desktop app e baixe seu arquivo JSON para um local privado fora do repositório de código-fonte. Uma chave de API não autoriza uploads.
O fluxo OAuth para desktop do Google usa um navegador e um listener local de callback. Este exemplo é para uma aplicação local interativa; um servidor remoto sem interface gráfica precisa de um projeto de autorização separado. Durante o consentimento, selecione o canal desejado do YouTube, incluindo a conta de marca quando aplicável. Uma conta do Google pode ter mais de um canal.
Configurar o cliente da API do YouTube
Comece em uma pasta com permissão de escrita fora de um projeto .NET existente. A proteção abaixo
rejeita configurações de projetos em diretórios superiores para que uma versão fixa do SDK ou
configurações de compilação herdadas não alterem silenciosamente este exemplo independente.
Ela cria uma nova pasta youtube-upload e mantém seu shell no diretório original.
Uma pasta existente é preservada e faz a configuração parar.
(
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
)
O pacote é o cliente da YouTube Data API para .NET do Google. Se a criação, a instalação ou a compilação falhar, corrija o erro informado antes de continuar. Mantenha todos os arquivos já criados; não cole o bloco de criação sobre um projeto existente.
Fazer upload de vídeos
Substitua o youtube-upload/Program.cs gerado por este programa completo. Ele usa
GoogleWebAuthorizationBroker e FileDataStore
para obter e manter a autorização do usuário. Um diretório de tokens está associado ao canal que
você selecionou durante o consentimento; o nome desse diretório não seleciona um canal.
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;
}
}
Na pasta de trabalho original, execute o comando a seguir após substituir todos os cinco
argumentos. Escolha um caminho privado ainda não utilizado para o diretório de tokens da primeira
autorização. O comando compila o programa salvo antes de executá-lo;
-- separa os argumentos da aplicação das opções do .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"
Conclua o fluxo de consentimento do Google no navegador. O programa solicita apenas
youtube.upload, um dos escopos aceitos por
videos.insert. Ele envia explicitamente
privacyStatus=private e notifySubscribers=false, cujo valor padrão seria true.
Quando o upload é aceito, o programa imprime Video ID: seguido do ID real. Salve esse ID e inspecione o vídeo no YouTube Studio, no canal selecionado. O argumento do ID do canal esperado verifica os metadados retornados após o upload; ele não seleciona o destino nem impede um upload para um canal autorizado por engano. Se a verificação falhar, o programa termina sem sucesso, mas imprime o ID retornado para que você localize o vídeo.
Os bytes enviados indicam o progresso do transporte. Mesmo um upload concluído com um ID não
comprova que o YouTube terminou de processar um vídeo reproduzível. Confira o processamento no
YouTube Studio antes de publicar; o Google documenta um
processingDetails.processingStatus separado para essa etapa.
Lidar com cotas e limites de requisições
Confira os limites atuais do seu projeto no Google Cloud e na
calculadora de cotas do YouTube antes de automatizar uploads.
Em 5 de novembro de 2026, o padrão documentado é uma cota separada de 100 chamadas a
videos.insert por dia, além de limites separados para pesquisa e outros
endpoints. As cotas diárias são reiniciadas à meia-noite no horário do Pacífico. Requisições
inválidas também consomem cota.
Um contador local não consegue contabilizar outros processos, reinicializações ou todas as requisições do SDK. Este exemplo faz uma tentativa de inserção no nível da aplicação; ele não implementa um agendador de cotas para todo o projeto.
Tratar falhas antes de tentar novamente
Um código de saída diferente de zero pode significar recusa, cancelamento, tempo limite excedido ou perda da resposta após o YouTube aceitar o vídeo. O app solicita o cancelamento da autorização e do upload após dez minutos e configura um tempo limite HTTP de 60 segundos por requisição de upload. O cancelamento é cooperativo, não uma garantia de encerramento do processo, e uma conexão lenta pode interromper um upload que seria válido. Nenhum desses tempos limite comprova que uma gravação remota foi revertida.
O SDK usa requisições de upload retomável, mas este programa não salva o URI da sessão para
recuperação após o término do processo. Não coloque o comando dotnet run
inteiro em um loop de novas tentativas: um novo videos.insert pode criar um
segundo vídeo quando a primeira resposta foi perdida. Inspecione o canal desejado e qualquer ID
de vídeo impresso antes de decidir se deve tentar novamente. A saída de progresso, sozinha, não
permite determinar um resultado desconhecido.
Manter a autorização vinculada ao canal
FileDataStore persiste tokens; ele não é um cofre de credenciais criptografado.
Restrinja o acesso ao JSON do cliente e ao diretório de tokens e mantenha ambos fora do controle
de versão. Reutilizar o diretório pode dispensar o navegador, portanto uma execução bem-sucedida
com dados em cache não comprova uma nova seleção de canal. Para autorizar outro canal, escolha
outro caminho privado ainda não utilizado para o diretório de tokens e conclua o consentimento
novamente.
Agora você tem um ponto de entrada de console para um único upload, cujo resultado confirmado é um ID de vídeo privado. Mantenha o vídeo privado até conferir seu canal, conteúdo e resultado do processamento no YouTube Studio. Para conhecer os campos de requisição disponíveis além dos usados neste exemplo, consulte a referência oficial de upload.
Prefere não executar isso por conta própria?
A Transloadit exporta arquivos para S3, Azure, Google Cloud e outros destinos como um Step em uma única chamada de API.
