YouTube Data API - Errors

Este documento identifica os diferentes tipos de erros que operações da YouTube Data API podem retornar. Você também pode encontrar uma lista de erros para qualquer método individual na documentação de referência desse método.

  1. Erros gerais
  2. activities
  3. channelBanners
  4. channels
  5. guideCategories
  6. playlistItems
  7. playlists
  8. search
  9. subscriptions
  10. thumbnails
  11. videoCategories
  12. videos

Erros gerais

As tabelas abaixo identificam mensagens de erro de API que não são específicas a um determinado método de API.

Core API errors

Tipo de erro Detalhe do erro Descrição
forbidden forbidden Acesso proibido. A solicitação não pode ser devidamente autorizada.
quotaExceeded quotaExceeded A solicitação não pode ser concluída porque você excedeu sua cota.

Common request errors

Tipo de erro Detalhe do erro Descrição
badRequest incompatibleParameters A solicitação especifica dois ou mais parâmetros que não podem ser utilizados na mesma solicitação.
badRequest invalidFilters A solicitação especifica um parâmetro de filtro inválido.
badRequest invalidPageToken A solicitação especifica um token de página inválido.
badRequest missingRequiredParameter A solicitação não contém um parâmetro obrigatório.
badRequest unexpectedParameter A solicitação especifica um parâmetro inesperado.
forbidden accountDelegationForbidden O usuário autenticado não pode agir em nome da conta do Google especificada.
forbidden authenticatedUserAccountClosed A conta do YouTube do usuário autenticado está fechada. Caso o usuário autenticado esteja agindo em nome de outra conta do Google, esse erro se refere a este último.
forbidden authenticatedUserAccountSuspended A conta do YouTube do usuário autenticado está suspensa. Caso o usuário autenticado esteja agindo em nome de outra conta do Google, esse erro se refere a este último.
forbidden authenticatedUserNotChannel Para esta solicitação, o usuário autenticado deve solucionar para um canal, mas não o faz. Se a solicitação estiver autenticada e usar o parâmetro de delegação onBehalfOfContentOwner, você também deverá definir o parâmetro onBehalfOfContentOwnerChannel.
forbidden channelClosed O canal identificado na solicitação foi fechado.
forbidden channelNotFound O canal identificado na solicitação não pode ser encontrado.
forbidden channelSuspended O canal identificado na solicitação foi suspenso.
forbidden cmsUserAccountNotFound O usuário do CMS não está autorizado a agir em nome do proprietário do conteúdo especificado.
forbidden insufficientCapabilities O usuário do CMS tem recursos insuficientes.
notFound contentOwnerAccountNotFound A conta do proprietário do conteúdo especificado não foi encontrada.

Request context errors

Tipo de erro Detalhe do erro Descrição
badRequest invalidLanguage O valor do parâmetro hl não especifica um código de idioma válido.
badRequest invalidMine O uso da solicitação do parâmetro mine não é suportado.
badRequest invalidPart O parâmetro part da solicitação especifica algumas seções que não podem ser gravadas simultaneamente.
badRequest invalidRegionCode O parâmetro regionCode especifica um código de região inválido.
badRequest unexpectedPart O parâmetro part da solicitação especifica um valor inesperado.
badRequest unknownPart O parâmetro part da solicitação especifica um valor desconhecido.
badRequest unsupportedLanguageCode O valor do parâmetro hl não especifica um código de idioma suportado.
badRequest unsupportedRegionCode O parâmetro regionCode especifica um código de região não suportado.
unauthorized authorizationRequired A solicitação usa o parâmetro mine, mas não está devidamente autorizada.
unauthorized youtubeSignupRequired Este erro indica que o usuário possui uma conta do Google desvinculada, o que significa que o usuário tem uma Conta do Google, mas não tem um canal no YouTube. Esses usuários podem acessar diversos recursos que dependem da autorização do usuário, como classificação ou adição de vídeos a uma playlist watch_later. No entanto, como exemplo, o usuário precisaria de um canal no YouTube para poder fazer upload de um vídeo. Um usuário que possui uma conta do Gmail ou um dispositivo Android possui uma Conta do Google, mas pode não ter vinculado ainda essa Conta do Google a um canal no YouTube.

Esse erro normalmente ocorre quando você tenta usar o fluxo da Conta de Serviço do OAuth 2.0. Como o YouTube não suporta Contas de Serviço, se você tentar autenticar usando uma Conta de Serviço, ocasionará esse erro.

O post no blog da API do YouTube que introduz o suporte da conta do Google também discute o erro youtubeSignupRequired mais detalhadamente. Embora o post do blog explique o erro para a versão 2.1 da API, o significado do erro ainda é aplicável.

activities

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de activities. Esses métodos também podem retornar erros listados na seção Erros comuns.

activities.list

Tipo de erro Detalhe do erro Descrição
notFound channelNotFound O ID de canal identificado pelo parâmetro channelId da solicitação não pode ser encontrado.
notFound homeChannelNotFound O feed da página inicial do YouTube não pode ser encontrado para o usuário autenticado no momento.
unauthorized authorizationRequired A solicitação usa o parâmetro home, mas não está devidamente autorizada.

activities.insert

Tipo de erro Detalhe do erro Descrição
badRequest bulletinTextRequired A solicitação deve usar a propriedade description do objeto snippet para fornecer o texto para a postagem do boletim.
notFound playlistNotFound O YouTube não consegue encontrar o vídeo que você está tentando associar à postagem do boletim. Verifique o valor da propriedade contentDetails.bulletinPosted.playlistId.
notFound videoNotFound O YouTube não consegue encontrar o vídeo que você está tentando associar à postagem do boletim. Verifique o valor da propriedade contentDetails.bulletinPosted.videoId.
userRateLimitExceeded rateLimitExceeded A solicitação não pode ser concluída porque você excedeu sua cota.

channelBanners

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de channelBanners. Esses métodos também podem retornar erros listados na seção Erros comuns.

channelBanners.insert

Tipo de erro Detalhe do erro Descrição
badRequest mediaBodyRequired A solicitação não inclui o conteúdo da imagem.

channels

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de channels. Esses métodos também podem retornar erros listados na seção Erros comuns.

channels.list

Tipo de erro Detalhe do erro Descrição
forbidden channelForbidden O canal especificado pelo parâmetro id não suporta a solicitação ou a solicitação não está apropriadamente autorizada.
notFound categoryNotFound A categoria identificada pelo parâmetro categoryId não pode ser encontrada. Use o método guideCategories.list para recuperar uma lista de valores válidos.
notFound channelNotFound O canal especificado no parâmetro id não pode ser encontrado.

channels.update

Tipo de erro Detalhe do erro Descrição
badRequest brandingValidationError Um dos valores no objeto brandingSettings não passou na validação. Use o método channels.list para recuperar as configurações existentes para o canal e atualize os valores da propriedade seguindo as orientações contidas na documentação do recurso channels.
badRequest invalidBrandingOption Uma das configurações de marca que você especificou não existe. Use o método channels.list para recuperar valores válidos e não se esqueça de atualizá-los seguindo as orientações contidas na documentação do recurso channels.
badRequest invalidCornerPosition Os metadados da solicitação especificam uma posição de canto inválido para identificar o local em que o item promovido será exibido. Verifique o valor da propriedade invideoPromotion.position.cornerPosition no recurso que a solicitação enviou.
badRequest invalidItemType Os metadados da solicitação especificam um tipo de item inválido na parte invideoPromotion. Verifique o valor da propriedade invideoPromotion.items[].type no recurso que a solicitação enviou.
badRequest invalidPositionOffset Os metadados da solicitação especificam um tipo de posição inválido para determinar como o item promovido está posicionado no player de vídeo. Verifique o valor da propriedade invideoPromotion.position.type no recurso que a solicitação enviou.
badRequest invalidTimingOffset Os metadados da solicitação especificam um ajuste de horário inválido para determinar quando o item promovido deve ser exibido no player de vídeo. Verifique o valor da propriedade invideoPromotion.timing.offsetMs no recurso que a solicitação enviou.
badRequest invalidTimingType Os metadados da solicitação especificam um método de tempo inválido para determinar quando o item promovido deve ser exibido no player de vídeo. Verifique o valor da propriedade invideoPromotion.timing.type no recurso que a solicitação enviou.
forbidden channelForbidden O canal especificado no parâmetro id não suporta a solicitação ou a solicitação não está corretamente autorizada.
notFound channelNotFound O canal especificado pelo parâmetro id não pode ser encontrado ou não possui opções de marca.
notFound unknownChannelId O canal que a solicitação da API está tentando atualizar não pode ser encontrado. Verifique o valor da propriedade id no recurso channel que a solicitação enviou para assegurar que o ID do canal esteja correta.
notFound unknownVideoId O ID do vídeo especificada como um item promovido não pode ser encontrada.
required requiredCornerPosition Os metadados da solicitação devem especificar uma posição de canto para que o YouTube possa determinar onde exibir o item promovido no player. Defina o valor da propriedade invideoPromotion.position.cornerPosition no recurso que a solicitação envia.
required requiredItemType Os metadados da solicitação devem especificar o tipo de item promovido. Defina o valor da propriedade invideoPromotion.items[].type no recurso que a solicitação envia.
required requiredPositionOffset Os metadados da solicitação devem especificar um tipo de posição para que o YouTube possa determinar como exibir o item promovido. Defina o valor da propriedade invideoPromotion.position.type no recurso que a solicitação envia.
required requiredTimingOffset Os metadados da solicitação devem especificar um ajuste de horário para que o YouTube possa determinar quando exibir o item promovido. Defina o valor da propriedade invideoPromotion.timing.offsetMs no recurso que a solicitação envia.
required requiredTimingType Os metadados da solicitação devem especificar um método de horário para que o YouTube possa determinar quando exibir o item promovido. Defina o valor da propriedade invideoPromotion.timing.type no recurso que a solicitação envia.
required requiredVideoId Os metadados da solicitação devem especificar um ID de vídeo para identificar o item promovido.

guideCategories

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de guideCategories. Esses métodos também podem retornar erros listados na seção Erros comuns.

guideCategories.list

Tipo de erro Detalhe do erro Descrição
notFound notFound A categoria de guia determinada pelo parâmetro id não pode ser encontrada. Use o método guideCategories.list para recuperar uma lista de valores válidos.

playlistItems

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de playlistItems. Esses métodos também podem retornar erros listados na seção Erros comuns.

playlistItems.delete

Tipo de erro Detalhe do erro Descrição
forbidden playlistItemsNotAccessible A solicitação não está devidamente autorizada a excluir o item da playlist especificado.
notFound playlistItemNotFound O item da playlist indicado com o parâmetro id da solicitação não pode ser encontrado.

playlistItems.insert

Tipo de erro Detalhe do erro Descrição
duplicate videoAlreadyInPlaylist O vídeo que você está tentando adicionar à playlist já foi adicionado.
forbidden playlistContainsMaximumNumberOfVideos A playlist já contém o número máximo permitido de itens.
invalidValue invalidPlaylistItemPosition A solicitação tenta definir a posição do item da playlist com um valor inválido ou não suportado. Verifique o valor da propriedade position no snippet do recurso.
invalidValue invalidResourceType O type especificado para o ID do recurso não é suportado para esta operação. O ID do recurso identifica o item que está sendo adicionado à playlist - por exemplo, youtube#video.
notFound playlistNotFound A playlist identificada com o parâmetro playlistId da solicitação não pode ser encontrada.
notFound videoNotFound O vídeo que você está tentando adicionar à playlist não pode ser encontrado. Verifique o valor da propriedade videoId para garantir que ele esteja correto.
required channelIdRequired A solicitação não especifica um valor para a propriedade channelId necessária.
required playlistIdRequired A solicitação não especifica um valor para a propriedade playlistId necessária.
required resourceIdRequired A solicitação deve conter um recurso em que o objeto snippet especifica um resourceId.

playlistItems.list

Tipo de erro Detalhe do erro Descrição
forbidden playlistItemsNotAccessible A solicitação não está devidamente autorizada a recuperar a playlist especificada.
notFound playlistNotFound A playlist identificada com o parâmetro playlistId da solicitação não pode ser encontrada.
notFound videoNotFound O vídeo identificado com o parâmetro videoId da solicitação não pode ser encontrado.
required playlistIdRequired A solicitação de inscrição não especifica um valor para a propriedade playlistId necessária.

playlistItems.update

Tipo de erro Detalhe do erro Descrição
invalidValue invalidPlaylistItemPosition A solicitação tenta definir a posição do item da playlist com um valor inválido ou não suportado. Verifique o valor da propriedade position no snippet do recurso.
invalidValue invalidResourceType O type especificado para o ID do recurso não é suportado para esta operação. O ID do recurso identifica o item que está sendo adicionado à playlist (youtube#video, por exemplo).
invalidValue invalidSnippet A solicitação não especifica uma propriedade snippet válida.
notFound playlistItemNotFound O item da playlist indicado com a propriedade id da solicitação não pode ser encontrado.
notFound playlistNotFound A playlist identificada com o parâmetro playlistId da solicitação não pode ser encontrada.
required channelIdRequired A solicitação não especifica um valor para a propriedade channelId necessária.
required playlistIdRequired A solicitação não especifica um valor para a propriedade playlistId necessária.
required playlistItemIdRequired O recurso do item da playlist especificado na solicitação deve usar a propriedade id para indicar o item da playlist que está sendo atualizado.

playlists

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de playlists. Esses métodos também podem retornar erros listados na seção Erros comuns.

playlists.delete

Tipo de erro Detalhe do erro Descrição
notFound playlistNotFound A playlist indicada com o parâmetro id da solicitação não pode ser encontrada.

playlists.insert

Tipo de erro Detalhe do erro Descrição
invalidValue invalidPlaylistSnippet A solicitação fornece um snippet de playlist inválido.
required playlistTitleRequired A solicitação deve especificar um título da playlist.

playlists.update

Tipo de erro Detalhe do erro Descrição
invalidValue invalidPlaylistSnippet A solicitação fornece um snippet de playlist inválido.
notFound playlistNotFound A playlist indicada com o parâmetro id da solicitação não pode ser encontrada.
required playlistTitleRequired A solicitação deve especificar um título da playlist.

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de search. Esses métodos também podem retornar erros listados na seção Erros comuns.

search.list

Tipo de erro Detalhe do erro Descrição
badRequest invalidSearchFilter A solicitação contém uma combinação inválida de filtros de pesquisa e/ou restrições.
badRequest invalidVideoId O parâmetro relatedToVideo especificou um ID de vídeo inválida.

subscriptions

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de subscriptions. Esses métodos também podem retornar erros listados na seção Erros comuns.

subscriptions.delete

Tipo de erro Detalhe do erro Descrição
badRequest accountClosed A conta que está tentando criar a inscrição foi fechada.
badRequest accountSuspended A conta que está tentando criar a inscrição foi suspensa.
forbidden subscriptionForbidden A solicitação não está devidamente autenticada ou não é suportada para este canal.
notFound subscriptionNotFound A inscrição que você está tentando excluir não pode ser encontrada. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

subscriptions.insert

Tipo de erro Detalhe do erro Descrição
badRequest accountClosed A conta que está tentando criar a inscrição foi fechada.
badRequest accountSuspended A conta que está tentando criar a inscrição foi suspensa.
badRequest subscriptionDuplicate A inscrição que você está tentando criar já existe.
forbidden subscriptionForbidden A solicitação não está devidamente autenticada ou não é suportada para este canal.
notFound publisherNotFound O recurso especificado pela propriedade snippet.resourceId da solicitação não pode ser encontrado.
notFound subscriberNotFound O assinante identificado com a solicitação não pode ser encontrado.
required publisherRequired O recurso de inscrição especificado na solicitação deve usar a propriedade snippet.resourceId para identificar o canal ao qual ele está sendo inscrito.

subscriptions.list

Tipo de erro Detalhe do erro Descrição
forbidden accountClosed As inscrições não podem ser recuperadas porque a conta do assinante está fechada.
forbidden accountSuspended As inscrições não podem ser recuperadas porque a conta do assinante está suspensa.
forbidden subscriptionForbidden O solicitante não tem permissão para acessar as inscrições solicitadas.
notFound subscriberNotFound O assinante identificado com a solicitação não pode ser encontrado.

thumbnails

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de thumbnails. Esses métodos também podem retornar erros listados na seção Erros comuns.

thumbnails.set

Tipo de erro Detalhe do erro Descrição
badRequest mediaBodyRequired A solicitação não inclui o conteúdo da imagem.
forbidden forbidden O usuário autenticado não tem permissões para carregar e configurar miniaturas de vídeo personalizadas.
forbidden forbidden A miniatura não pode ser configurada para o vídeo especificado. A solicitação pode não ser devidamente autorizada.
notFound videoNotFound O vídeo no qual você está tentando inserir uma imagem em miniatura não pode ser encontrado. Verifique o valor do parâmetro videoId da solicitação para garantir que ele esteja correto.

videoCategories

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de videoCategories. Esses métodos também podem retornar erros listados na seção Erros comuns.

videoCategories.list

Tipo de erro Detalhe do erro Descrição
notFound videoCategoryNotFound A categoria de vídeo determinada pelo parâmetro id não pode ser encontrada. Use o método videoCategories.list para recuperar uma lista de valores válidos.

videos

As tabelas abaixo identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de videos. Esses métodos também podem retornar erros listados na seção Erros comuns.

videos.insert

Tipo de erro Detalhe do erro Descrição
badRequest invalidCategoryId A propriedade snippet.categoryId especifica um ID de categoria inválida. Use o método videoCategories.list para recuperar categorias suportadas.
badRequest invalidDescription Os metadados da solicitação especificam uma descrição de vídeo inválida.
badRequest invalidFilename O nome do arquivo de vídeo especificado no cabeçalho Slug é inválido.
badRequest invalidRecordingDetails O objeto recordingDetails nos metadados da solicitação especifica detalhes de gravação inválidos.
badRequest invalidTags Os metadados da solicitação especificam palavras-chave de vídeo inválidas.
badRequest invalidTitle Os metadados da solicitação especificam um título de vídeo inválido.
badRequest invalidVideoGameRating Os metadados da solicitação especificam uma classificação de video game inválida.
badRequest invalidVideoMetadata Os metadados da solicitação são inválidos.
badRequest mediaBodyRequired A solicitação não inclui o conteúdo da vídeo.
forbidden forbiddenLicenseSetting A solicitação tenta definir uma licença inválida para o vídeo.
forbidden forbiddenPrivacySetting A solicitação tenta definir uma configuração de privacidade inválida para o vídeo.

videos.list

Tipo de erro Detalhe do erro Descrição
badRequest videoChartNotFound O gráfico de vídeo solicitado não é suportado ou não está disponível.
forbidden forbidden A solicitação não pode acessar informações de avaliação do usuário. Este erro pode ocorrer porque a solicitação não está devidamente autorizada a usar o parâmetro myRating.

videos.delete

Tipo de erro Detalhe do erro Descrição
forbidden forbidden O vídeo que você está tentando excluir não pode ser excluído. A solicitação pode não ser devidamente autorizada.
notFound videoNotFound O vídeo que você está tentando excluir não pode ser encontrado. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

videos.update

Tipo de erro Detalhe do erro Descrição
badRequest invalidRequest Os metadados da solicitação são inválidos.
forbidden forbidden
forbidden forbiddenLicenseSetting A solicitação tenta definir uma licença inválida para o vídeo.
forbidden forbiddenPrivacySetting A solicitação tenta definir uma configuração de privacidade inválida para o vídeo.
notFound videoNotFound O vídeo que você está tentando atualizar não pode ser encontrado. Verifique o valor do campo id no corpo da solicitação para garantir que ele esteja correto.

videos.rate

Tipo de erro Detalhe do erro Descrição
forbidden forbidden O vídeo que você está tentando classificar não pode ser classificado. A solicitação pode não estar devidamente autorizada.
notFound videoNotFound O vídeo que você está tentando classificar não pode ser encontrado. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.