O que uma extensão de cota da API do YouTube custa em papelada

O que é uma extensão de cota da API do YouTube?

Toda extensão de cota da API do YouTube é resultado de uma auditoria e não de uma mudança de configuração: o próprio guia do Google afirma que "if you would like to request additional quota beyond the default allocation, you must first complete an audit to show that your project is in compliance with the YouTube API Services Terms of Service." Não existe um controle deslizante no Cloud Console que eleve um limite da YouTube Data API. Existe um formulário, uma análise do time de API Services do YouTube e uma decisão.

Essa é a regra desde 1 de julho de 2021, quando o histórico de revisões do YouTube anunciou que "all developers using YouTube's API Services must complete an API Compliance Audit in order to be granted more than the default quota allocation of 10,000 units."

O único caminho para mais cota

Cota padrão

Formulário de auditoria e extensão de cota

Revisão pela equipe de API Services do YouTube

Decisão

Qual é a cota padrão?

O padrão não é mais um número único, e essa é a parte que a maioria dos textos ainda erra. A partir da mudança de 1 de junho de 2026, as páginas de cota do Google dizem:

"Projects that enable the YouTube Data API have a default quota allocation of 100 search.list calls, 100 videos.insert calls, and 10,000 units per day combined for all other endpoints."

Dois métodos agora ficam em baldes próprios. O histórico de revisões descreve isso como "transitioning to a granular quota system covering smaller sets of methods, starting with videos.insert and search.list", para que o YouTube possa "more easily verify and approve requests based on specific method usage." Um terceiro balde chegou em 3 de junho de 2026 com videos.batchGetStats, que tem "a quota cost of 1 unit in its own granular quota bucket" e "a default quota of 10,000 units per day."

As cotas diárias zeram à meia-noite no horário do Pacífico.

Quanto custa cada chamada?

Os custos vêm da Quota Calculator. Operações de leitura são baratas, escritas não.

Método	Custo
activities.list, channels.list, videos.list, playlists.list, comments.list	1 unidade
videos.getRating	1 unidade
videos.update, videos.rate, videos.delete, videos.reportAbuse	50 unidades
playlists.insert, playlistItems.insert, subscriptions.insert	50 unidades
thumbnails.set, channels.update, watermarks.set	50 unidades
captions.insert	400 unidades
captions.update	450 unidades
search.list	100 por dia, 1 unidade por chamada
videos.insert	100 por dia, 1 unidade por chamada

Duas coisas estreitam o orçamento mais rápido do que a tabela sugere. "All API requests, including invalid requests, incur a quota cost of at least one point", então uma chamada malformada ainda é cobrada. E a paginação se acumula: se um método "returns multiple pages of results, each request to retrieve an additional page of results incurs the estimated quota cost."

Onde a própria documentação do Google se contradiz?

Na página da Quota Calculator, em dois lugares ao mesmo tempo.

O texto do corpo e a tabela dizem que videos.insert tem limite diário padrão de 100 e que "the quota cost is 1 per call." O Page Summary gerado automaticamente no topo da mesma página, atualizado pela última vez em 2026-09-04, diz outra coisa: "The table shows that methods like videos.insert have the highest cost of 1600 points." O resumo legível por máquina no pé da página repete isso, descrevendo custos "ranging from 1 for actions such as list to 1600 for actions like videos insert."

O número de 1.600 é um fóssil. A entrada do histórico de revisões de 4 de dezembro de 2025 registra que a documentação foi "updated to reflect a change in the quota cost of a video upload from approximately 1600 units to approximately 100 units", e a mudança de baldes de junho de 2026 tirou os uploads do pote compartilhado por completo. O widget de resumo nunca acompanhou. Se você orça a partir do número 1.600, está orçando contra um custo que o Google aposentou dez meses atrás, em uma página que ainda o mostra.

Existe um segundo descompasso, menor. A página Quota and Compliance Audits traz uma linha de resumo dizendo "with a default allocation of 10,000 units per day", enquanto o corpo dessa mesma página lista a cota em três partes. As duas foram atualizadas pela última vez em 2026-09-04.

O que o formulário pede de fato?

Uma URL cobre a maior parte: https://support.google.com/youtube/contact/yt_api_form, o YouTube API Services Audit and Quota Extension Form. O Google encaminha três situações separadas para esse mesmo endereço. Iniciar uma auditoria, pedir uma extensão depois de passar em uma auditoria nos últimos 12 meses e concluir uma auditoria periódica sobre a qual você foi contatado passam todos por ele. Uma auditoria reprovada vai para outro endereço, yt_api_appeals, e uma mudança de controle vai para yt_api_change_of_control_form.

O formulário abre pedindo que você selecione o motivo da solicitação, com duas opções: concluir uma auditoria de conformidade para pedir cota adicional, ou concluir uma auditoria de conformidade para manter a cota atual se você foi chamado a reauditar. Depois disso ele coleta, nesta ordem:

• Dados da organização e de contato. Nome legal completo, nome legal da organização, empresa controladora, uma URL de site principal que precisa começar com https://, um endereço legal completo, uma categoria de negócio, um porte de organização e contatos primário, técnico e comercial separados.
• Modelo de negócio. Uma descrição do seu trabalho relacionado ao YouTube com mínimo de 100 caracteres e teto de 5.000 caracteres, seu público-alvo, seu modelo de monetização, perguntas sobre posicionamento de anúncios e se o YouTube aprovou, e qualquer relação existente com um representante do Google.
• Visão geral do cliente de API. O nome do cliente e se ele contém a palavra "YouTube", a URL de acesso principal, a URL da política de privacidade, a URL dos termos de serviço, se o cliente é acessível publicamente e credenciais de conta de demonstração incluindo usuário, senha e quaisquer instruções especiais de acesso.
• Casos de uso e cota. Entre um e dez projetos. Para cada um: o número do projeto no Google Cloud, categorias de caso de uso, se OAuth é necessário, volume diário esperado, capturas de tela da sua política de privacidade, da home e dos termos, capturas condicionais do fluxo OAuth, da interface de upload ou do painel, os endpoints específicos de que você precisa e um número total de cota diária com justificativa.

O bloco de credenciais de demonstração é o que trava os times, mesmo com o formulário deixando esses campos como opcionais. Um beta fechado, uma ferramenta interna ou um cliente cuja única porta de entrada fica atrás de um paywall ainda precisa oferecer alguma forma de um revisor ver o cliente funcionando.

O que o Google não documenta?

Tudo sobre o resultado.

O Google publica as URLs do formulário, a exigência de auditoria, a cota padrão e os custos por método. Ele não publica prazo de análise, nível de serviço, critério de aprovação, régua de pontuação, política de aprovação parcial nem prazo para recursos. O Appeals Form existe para projetos que "recently failed an API Compliance Audit", e "recently" é o único qualificador dado.

O que os solicitantes relatam em fóruns públicos de desenvolvedores são esperas longas e variáveis, decisões que concedem menos cota do que a pedida e submissões sem resposta por meses. Esses relatos valem conhecer, mas são reclamações autosselecionadas e não uma distribuição publicada, e nenhum deles é um compromisso do Google. Planeje com base nas partes documentadas e trate o resto como sem limite.

A resposta prática é não precisar da extensão. Guarde em cache com agressividade, use videos.list com valores explícitos de part em vez de search.list onde um ID já é conhecido, e agrupe leituras. A mesma disciplina vale para toda rede com API medida, dos limites de escrita por pontos do Bluesky aos tetos por endpoint do Pinterest e aos 100 posts por 24 horas do Instagram. Se sua carga de trabalho é publicação e não análise, a comparação de APIs de agendamento é um ponto de partida mais útil do que um pedido de cota.

Perguntas frequentes

Quanta cota da YouTube Data API eu recebo por padrão?

100 chamadas de search.list, 100 chamadas de videos.insert e 10.000 unidades por dia somadas para todos os outros endpoints. O Google afirma essa cota tanto na Quota Calculator quanto nas páginas de Quota and Compliance Audits. As cotas zeram à meia-noite no horário do Pacífico.

O videos.insert ainda custa 1.600 unidades?

Não. O histórico de revisões do Google registra a mudança de aproximadamente 1.600 unidades para aproximadamente 100 unidades em 4 de dezembro de 2025, e a mudança de baldes de junho de 2026 moveu os uploads para uma cota própria a 1 unidade por chamada com 100 chamadas por dia. O resumo gerado automaticamente na página da Quota Calculator ainda imprime 1.600, o que está desatualizado.

Dá para aumentar minha cota da API do YouTube sem auditoria?

Não. O guia do Google afirma que cota adicional além do padrão exige concluir uma auditoria antes. O Cloud Console mostra seu uso e seus limites, mas os limites em si são definidos pelo time de API Services do YouTube depois da análise.

Quanto tempo leva uma extensão de cota da API do YouTube?

O Google não publica prazo. A página Quota and Compliance Audits diz apenas que "a member of YouTube's API Services team will contact you as soon as possible." Relatos públicos de desenvolvedores descrevem esperas que vão de semanas a meses, com algumas submissões sem resposta, mas o Google não se compromete com nível de serviço nenhum.

O que acontece se eu for reprovado na auditoria?

Você pode enviar o Appeals Form em support.google.com/youtube/contact/yt_api_appeals, que cobre projetos que reprovaram recentemente em uma auditoria de conformidade ou tiveram um aumento de cota negado. O Google não publica os critérios usados nem na decisão original nem no recurso.

Que erro o YouTube devolve quando a cota acaba?

quotaExceeded, como um 403, descrito na documentação de erros da API como "the request cannot be completed because you have exceeded your quota." Um rateLimitExceeded separado aparece como 400 para o envio de requisições demais em um dado intervalo.

Qual é a URL exata do formulário de extensão de cota da API do YouTube?

O Google encaminha auditorias e pedidos de cota para https://support.google.com/youtube/contact/yt_api_form, o YouTube API Services Audit and Quota Extension Form. O mesmo endereço cobre três situações: iniciar uma auditoria, pedir uma extensão depois de passar em uma nos últimos 12 meses, e concluir uma reauditoria periódica.

Para onde vai uma auditoria da API do YouTube reprovada?

Uma auditoria reprovada ou um pedido de aumento de cota negado vai para o Appeals Form em support.google.com/youtube/contact/yt_api_appeals, um endereço diferente do formulário principal. O único critério que o Google dá é que o projeto tenha "reprovado recentemente em uma API Compliance Audit", sem prazo publicado nem critérios de avaliação para o próprio recurso.

Por que um pedido de cota da API do YouTube exige credenciais de uma conta de demonstração?

O formulário pede uma conta de demonstração funcional, com nome de usuário, senha e qualquer instrução de acesso especial, porque um revisor precisa entrar e ver o cliente em funcionamento antes de aprovar qualquer coisa. Um beta fechado, uma ferramenta interna ou um cliente escondido atrás de um paywall ainda deve fornecer uma conta que funcione, embora o formulário deixe esses campos de credenciais como opcionais.

Como evitar precisar de uma extensão de cota da API do YouTube?

Fazer cache de forma agressiva, chamar videos.list com valores explícitos de part em vez de search.list quando o ID já é conhecido, e agrupar leituras em lote em vez de disparar uma requisição por item. Essa disciplina mantém o uso diário dentro das 100 chamadas de search.list, das 100 chamadas de videos.insert e do conjunto de 10.000 unidades que a maioria dos projetos recebe por padrão, e evita um processo sem prazo nem critérios de aprovação publicados.