Referência de Erros da API do YouTubeGuia completo de resolução de problemas com soluções

Referência abrangente para erros da YouTube Data API. Encontre soluções para limites de upload, erros de cota, problemas com título/imagem em miniatura e questões de autenticação.

11 códigos de erro

•

5 categories

•

Data API v3

← Voltar à Integração YouTube View API Documentation

Categorias de Erros

Authentication

2 errors

Upload

4 errors

Account

1 error

Quota

2 errors

Content

2 errors

Todos os Códigos de Erro

#Authentication

invalid_grantrefresh-token

O token de acesso do YouTube expirou. Por favor, reconecte sua conta do YouTube.

Solução:

Seu token de acesso do YouTube/Google expirou ou foi revogado. Acesse as configurações da sua conta e reconecte sua conta do YouTube para obter um novo token de acesso.

token has been expired or revokedrefresh-token

O token de acesso do YouTube expirou. Por favor, reconecte sua conta do YouTube.

Solução:

Seu token não é mais válido. Isso pode acontecer após uma alteração de senha ou revisão de segurança. Reconecte sua conta do YouTube para estabelecer uma nova sessão.

#Upload

invalidTitleuser-error

O título do vídeo é muito longo. Os títulos do YouTube devem ter 100 caracteres ou menos.

Solução:

Reduza o título do seu vídeo para 100 caracteres ou menos. O YouTube impõe rigorosamente esse limite para todos os uploads.

failedPreconditionuser-error

O tamanho da miniatura é muito grande. Por favor, utilize uma imagem menor (máx. 2MB).

Solução:

O seu thumbnail personalizado excede o limite de tamanho de 2MB do YouTube. Comprimir a imagem do thumbnail para menos de 2MB. O tamanho recomendado é 1280x720 pixels.

youtube.thumbnailuser-error

Sua conta do YouTube não está verificada. Carregamos seu vídeo, mas não conseguimos definir a miniatura. Por favor, verifique sua conta e tente novamente.

Solução:

Contas do YouTube não verificadas não podem definir miniaturas personalizadas. Verifique sua conta em youtube.com/verify usando um número de telefone. O vídeo foi enviado com sucesso.

uploadLimitExceededuser-error

Você atingiu o limite diário de uploads no YouTube. Tente novamente amanhã.

Solução:

O YouTube limita os uploads com base no status da sua conta. Contas novas podem ter um limite de 10 uploads por dia. Aguarde 24 horas ou verifique sua conta em youtube.com/verify.

#Account

youtubeSignupRequireduser-error

A configuração do canal do YouTube não está completa. Por favor, crie um canal no YouTube antes de enviar vídeos.

Solução:

Primeiro, você precisa criar um canal no YouTube. Acesse youtube.com e clique em 'Criar um canal'. Siga o assistente de configuração para concluir a criação do seu canal.

#Quota

quotaExceededretry

Quota da API do YouTube excedida. Por favor, tente novamente mais tarde.

Solução:

Você excedeu os limites de cota da API do YouTube. A cota padrão é de 10.000 unidades por dia. Aguarde até que sua cota seja redefinida (meia-noite, horário do Pacífico) ou solicite um aumento de cota ao Google.

quotaretry

Quota da API do YouTube excedida. Tente novamente mais tarde.

Solução:

A API de Dados do YouTube possui cotas de uso. Cada operação consome unidades de cota. Aguarde a redefinição da cota ou otimize o uso da sua API para reduzir o consumo de cota.

#Content

copyrightuser-error

O vídeo pode conter conteúdo protegido por direitos autorais. Por favor, consulte as políticas de direitos autorais do YouTube.

Solução:

O YouTube detectou possíveis problemas de direitos autorais. Certifique-se de ter os direitos sobre todo o conteúdo do seu vídeo. Revise as diretrizes de direitos autorais do YouTube e utilize músicas/imagens isentas de royalties.

content iduser-error

O vídeo pode conter conteúdo protegido por direitos autorais. Por favor, consulte as políticas de direitos autorais do YouTube.

Solução:

O ID de conteúdo associou seu vídeo a material protegido por direitos autorais. Se você tiver permissão, pode contestar a reivindicação. Caso contrário, remova o conteúdo protegido e faça o reenvio.

Melhores Práticas

Tratamento de Erros

→Monitore o uso da cota e otimize as chamadas da API
→Valide o comprimento do título e o tamanho da miniatura antes do upload.
→Gerencie os requisitos de verificação de conta
→Implemente a detecção de direitos autorais

Dicas de Prevenção

→Mantenha os títulos com menos de 100 caracteres
→Utilize miniaturas com menos de 2MB (1280x720 recomendado)
→Verifique a conta para miniaturas personalizadas
→Utilize apenas conteúdo original ou licenciado.

Precisa de ajuda com YouTube Integration?

Nossa API gerencia automaticamente cenários de erro com uma lógica de reintento inteligente e registro detalhado.

Comece a Construir Ver Documentação