YouTube Data API - Errors

Este documento identifica os diferentes tipos de erros que as operações 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.

Erros gerais

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

Core API errors

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Acesso proibido. A solicitação não pode ser devidamente autorizada.
quotaExceeded (403) 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 (400) incompatibleParameters A solicitação especifica dois ou mais parâmetros que não podem ser utilizados na mesma solicitação.
badRequest (400) invalidFilters A solicitação especifica um parâmetro de filtro inválido.
badRequest (400) invalidPageToken A solicitação especifica um token de página inválido.
badRequest (400) missingRequiredParameter A solicitação não contém um parâmetro obrigatório.
badRequest (400) unexpectedParameter A solicitação especifica um parâmetro inesperado.
forbidden (403) accountDelegationForbidden O usuário autenticado não pode agir em nome da Conta do Google especificada.
forbidden (403) 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 ela.
forbidden (403) 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 ela.
forbidden (403) authenticatedUserNotChannel Para esta solicitação, o usuário autenticado deve solucionar para um canal, mas não o faz. Se a solicitação for autenticada e usar o parâmetro de delegação onBehalfOfContentOwner, também será necessário definir o parâmetro onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed O canal identificado na solicitação foi fechado.
forbidden (403) channelNotFound O canal identificado na solicitação não pode ser encontrado.
forbidden (403) channelSuspended O canal identificado na solicitação foi suspenso.
forbidden (403) cmsUserAccountNotFound O usuário do CMS não está autorizado a agir em nome do proprietário do conteúdo especificado.
forbidden (403) insufficientCapabilities O usuário do CMS tem recursos insuficientes.
forbidden (403) insufficientPermissions O token OAuth 2.0 fornecido para a solicitação especifica escopos insuficientes para acessar os dados solicitados.
notFound (404) contentOwnerAccountNotFound Não foi possível encontrar a conta do proprietário do conteúdo especificada.

Request context errors

Tipo de erro Detalhe do erro Descrição
badRequest (400) invalidLanguage O valor do parâmetro hl não especifica um código de idioma válido.
badRequest (400) invalidMine O uso do parâmetro mine na solicitação não é aceito.
badRequest (400) invalidMine O parâmetro mine não pode ser usado em solicitações em que o usuário autenticado é um parceiro do YouTube. Remova o parâmetro mine, faça a autenticação como um usuário do YouTube removendo o parâmetro onBehalfOfContentOwner ou aja como um dos canais do parceiro fornecendo o parâmetro onBehalfOfContentOwnerChannel, se disponível para o método chamado.
badRequest (400) invalidPart O parâmetro part da solicitação especifica algumas partes que não podem ser gravadas ao mesmo tempo.
badRequest (400) invalidRegionCode O parâmetro regionCode especifica um código de região inválido.
badRequest (400) unexpectedPart O parâmetro part da solicitação especifica um valor inesperado.
badRequest (400) unknownPart O parâmetro part da solicitação especifica um valor desconhecido.
badRequest (400) unsupportedLanguageCode O valor do parâmetro hl não especifica um código de idioma aceito.
badRequest (400) unsupportedRegionCode O parâmetro regionCode especifica um código de região sem suporte.
unauthorized (401) authorizationRequired A solicitação usa o parâmetro mine, mas não está autorizada corretamente.
unauthorized (401) 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 muitos recursos que dependem da autorização do usuário, como avaliar vídeos ou adicionar 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 tem uma conta do Gmail ou um dispositivo Android com certeza tem uma Conta do Google, mas pode não ter vinculado essa Conta do Google a um canal do YouTube.

Esse erro é comum quando você tenta usar o fluxo da conta de serviço OAuth 2.0. O YouTube não oferece suporte a contas de serviço. Se você tentar fazer a autenticação usando uma conta de serviço, vai receber esse erro.

A postagem do blog da API do YouTube que apresenta o suporte à Conta do Google também discute o erro youtubeSignupRequired com mais detalhes. Embora o post do blog explique o erro para a versão 2.1 da API, o significado do erro ainda é aplicável.

atividades

O YouTube desativou o recurso de boletim do canal. O método activities.insert não é mais compatível.

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

activities.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) homeParameterDeprecated Os dados de atividade da página inicial do usuário não estão disponíveis nessa API. Esse erro pode ocorrer se você definir o parâmetro home como true em uma solicitação não autorizada.
forbidden (403) forbidden A solicitação não está autorizada corretamente.
notFound (404) channelNotFound Não foi possível encontrar o ID do canal identificado pelo parâmetro channelId da solicitação.
notFound (404) homeChannelNotFound Não foi possível encontrar um feed da página inicial do YouTube para o usuário autenticado.
unauthorized (401) authorizationRequired A solicitação usa o parâmetro home, mas não está autorizada corretamente.

legendas

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos captions. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

captions.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden As permissões associadas à solicitação não são suficientes para excluir a faixa de legenda. A solicitação pode não es devidamente autorizada.
notFound (404) captionNotFound Não foi possível encontrar a faixa de legenda. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

captions.download

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden As permissões associadas à solicitação não são suficientes para fazer o download da faixa de legenda. A solicitação pode não es devidamente autorizada.
invalidValue (400) couldNotConvert Não foi possível converter os dados da faixa de legenda para o idioma e/ou formato solicitados. Verifique se os valores tfmt e tlang solicitados são válidos e se o snippet.status da faixa de legenda solicitada não é failed.
notFound (404) captionNotFound Não foi possível encontrar a faixa de legenda. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

captions.insert

Tipo de erro Detalhe do erro Descrição
badRequest (400) contentRequired A solicitação não contém o conteúdo da faixa de legenda.
conflict (409) captionExists O vídeo especificado já tem uma faixa de legenda com o snippet.language e o snippet.name especificados. Um vídeo pode ter várias faixas para o mesmo idioma, mas cada uma precisa ter um nome diferente.

Há várias maneiras de corrigir o erro. Você pode excluir a faixa atual e inserir uma nova ou mudar o nome da nova faixa antes de inseri-la.
forbidden (403) forbidden As permissões associadas à solicitação não são suficientes para fazer o upload da faixa de legenda. A solicitação pode não es devidamente autorizada.
invalidValue (400) invalidMetadata A solicitação contém valores de metadados inválidos, o que impede a criação da faixa. Confirme se a solicitação especifica valores válidos para as propriedades snippet.language, snippet.name e snippet.videoId. A propriedade snippet.isDraft também pode ser incluída, mas não é obrigatória.
notFound (404) videoNotFound Não foi possível encontrar o vídeo identificado pelo parâmetro videoId.
invalidValue (400) nameTooLong O snippet.name especificado na solicitação é muito longo. O tamanho máximo é de 150 caracteres.

captions.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Não foi possível recuperar uma ou mais faixas de legenda porque as permissões associadas à solicitação não são suficientes para recuperar os recursos solicitados. A solicitação pode não es devidamente autorizada.
notFound (404) captionNotFound Não foi possível encontrar uma ou mais das faixas de legenda especificadas. Esse erro ocorre se o parâmetro videoId identificar um vídeo real, mas o parâmetro id identificar IDs de faixa de legenda que não existem ou IDs de faixa associados a outros vídeos. Verifique os valores dos parâmetros id e videoId da solicitação para garantir que eles estejam corretos.
notFound (404) videoNotFound Não foi possível encontrar o vídeo identificado pelo parâmetro videoId.

captions.update

Tipo de erro Detalhe do erro Descrição
badRequest (400) contentRequired A solicitação não fez upload de um arquivo de legenda atualizado. O conteúdo real da faixa é obrigatório se o parâmetro sync estiver definido como true.
forbidden (403) forbidden As permissões associadas à solicitação não são suficientes para atualizar a faixa de legenda. A solicitação pode não es devidamente autorizada.
notFound (404) captionNotFound Não foi possível encontrar a faixa de legenda especificada. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

channelBanners

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

channelBanners.insert

Tipo de erro Detalhe do erro Descrição
badRequest (400) bannerAlbumFull O álbum de arte do canal do YouTube tem muitas imagens. Acesse http://photos.google.com, navegue até a página de álbuns e remova algumas imagens desse álbum.
badRequest (400) mediaBodyRequired A solicitação não inclui o conteúdo da imagem.

channelSections

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos channelSections. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

channelSections.delete

Tipo de erro Detalhe do erro Descrição
badRequest (400) notEditable Não é possível excluir esta seção do canal.
forbidden (403) channelSectionForbidden A solicitação não está devidamente autenticada ou não é suportada para este canal.
invalidValue (400) idInvalid A propriedade id especifica um ID de seção de canal inválido.
invalidValue (400) idRequired A propriedade id precisa especificar um valor que identifique a seção do canal que está sendo excluída.
notFound (404) channelNotFound O canal não foi encontrado.
notFound (404) channelSectionNotFound Não foi possível encontrar a seção do canal que você está tentando atualizar.

channelSections.insert

Tipo de erro Detalhe do erro Descrição
badRequest (400) defaultLanguageNotSetError A propriedade snippet.defaultLanguage do recurso channelSection precisa ser definida para inserir ou atualizar o objeto localizations desse recurso.
badRequest (400) invalidLanguage Uma das chaves de idioma do objeto localizations falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable Não é possível criar esta seção do canal.
badRequest (400) styleRequired O recurso channelSection precisa especificar um valor para o campo snippet.style.
badRequest (400) targetInvalidCountry Um dos valores na lista targeting.countries falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Um dos valores na lista targeting.languages falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Um dos valores na lista targeting.regions falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) typeRequired O recurso channelSection precisa especificar um valor para o campo snippet.type.
forbidden (403) channelSectionForbidden A solicitação não foi autenticada corretamente ou não é compatível com este canal.
invalidValue (400) channelNotActive Pelo menos um dos canais especificados não está ativo.
invalidValue (400) channelsDuplicated A solicitação falhou porque especificou canais duplicados.
invalidValue (400) channelsNeeded Se a propriedade snippet.type tiver um valor de multipleChannels, a propriedade contentDetails.channels[] precisará ser especificada e especificar pelo menos um canal.
invalidValue (400) channelsNotExpected O recurso fornecido com a solicitação especificou um valor para a propriedade contentDetails.channels[], mas não é esperado que canais sejam usados para esse tipo de seção.
invalidValue (400) contentDetailsNeeded O recurso que você está inserindo precisa conter um objeto contentDetails para esse tipo de seção do canal.
invalidValue (400) inValidPosition A propriedade snippet.position contém um valor inválido.
invalidValue (400) maxChannelSectionExceeded A solicitação não pode ser concluída porque o canal já tem o número máximo de seções.
invalidValue (400) maxChannelsExceeded A solicitação falhou porque tentou incluir muitos canais na seção de canais.
invalidValue (400) maxPlaylistExceeded A solicitação falhou porque tentou incluir muitas playlists na seção do canal.
invalidValue (400) onePlaylistNeeded Se a propriedade snippet.type tiver um valor de singlePlaylist, a propriedade contentDetails.playlists[] precisará especificar exatamente uma playlist.
invalidValue (400) ownChannelInChannels Não é possível incluir seu canal em uma seção que aparece nele.
invalidValue (400) playlistIsPrivate Uma ou mais das playlists especificadas são particulares e, portanto, não podem ser incluídas na seção do canal.
invalidValue (400) playlistsDuplicated A solicitação falhou porque especificou playlists duplicadas.
invalidValue (400) playlistsNeeded Se a propriedade snippet.type tiver um valor de singlePlaylist ou multiplePlaylists, a propriedade contentDetails.playlists[] precisará ser especificada.
invalidValue (400) playlistsNotExpected O recurso fornecido com a solicitação especificou um valor para a propriedade contentDetails.playlists[], mas não é esperado que playlists sejam usadas para esse tipo de seção do canal.
invalidValue (400) snippetNeeded É preciso especificar um snippet para criar a seção do canal.
invalidValue (400) titleLengthExceeded O valor da propriedade snippet.title é muito longo.
invalidValue (400) titleRequired Se a propriedade snippet.type tiver um valor de multiplePlaylists ou multipleChannels, defina o título da seção especificando um valor para a propriedade snippet.title.
notFound (404) channelNotFound Um ou mais dos canais especificados não podem ser encontrados.
notFound (404) playlistNotFound Não foi possível encontrar uma ou mais das playlists especificadas.

channelSections.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) channelSectionForbidden O solicitante não tem permissão para acessar as seções do canal solicitadas.
invalidValue (400) idInvalid A solicitação especifica um ID de seção de canal inválido.
invalidValue (400) invalidCriteria A solicitação não pôde ser concluída porque os critérios de filtro são inválidos.
notFound (404) channelNotFound Não foi possível encontrar o canal associado à solicitação.
notFound (404) channelSectionNotFound Não foi possível encontrar a seção do canal associada à solicitação.

channelSections.update

Tipo de erro Detalhe do erro Descrição
badRequest (400) defaultLanguageNotSetError A propriedade snippet.defaultLanguage do recurso channelSection precisa ser definida para inserir ou atualizar o objeto localizations desse recurso.
badRequest (400) invalidLanguage Uma das chaves de idioma do objeto localizations falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable Não é possível editar esta seção do canal.
badRequest (400) styleRequired O recurso channelSection precisa especificar um valor para o campo snippet.style.
badRequest (400) targetInvalidCountry Um dos valores na lista targeting.countries falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Um dos valores na lista targeting.languages falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Um dos valores na lista targeting.regions falhou na validação. Use o método channelSections.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) typeRequired O recurso channelSection precisa especificar um valor para o campo snippet.type.
forbidden (403) channelSectionForbidden A solicitação não foi autenticada corretamente ou não é compatível com este canal.
invalidValue (400) channelNotActive Pelo menos um dos canais especificados não está ativo.
invalidValue (400) channelsDuplicated A solicitação falhou porque especificou canais duplicados.
invalidValue (400) channelsNeeded Se a propriedade snippet.type tiver um valor de multipleChannels, a propriedade contentDetails.channels[] precisará ser especificada e especificar pelo menos um canal.
invalidValue (400) channelsNotExpected O recurso fornecido com a solicitação especificou um valor para a propriedade contentDetails.channels[], mas não é esperado que canais sejam usados para esse tipo de seção.
invalidValue (400) contentDetailsNeeded O recurso que você está atualizando precisa conter um objeto contentDetails para esse tipo de seção do canal.
invalidValue (400) idInvalid A propriedade id especifica um ID de seção de canal inválido.
invalidValue (400) idRequired A propriedade id precisa especificar um valor que identifique a seção do canal que está sendo atualizada.
invalidValue (400) inValidPosition A propriedade snippet.position contém um valor inválido.
invalidValue (400) maxChannelsExceeded A solicitação falhou porque tentou incluir muitos canais na seção de canais.
invalidValue (400) maxPlaylistExceeded A solicitação falhou porque tentou incluir muitas playlists na seção do canal.
invalidValue (400) onePlaylistNeeded Se a propriedade snippet.type tiver um valor de singlePlaylist, a propriedade contentDetails.playlists[] precisará especificar exatamente uma playlist.
invalidValue (400) ownChannelInChannels Não é possível incluir seu canal em uma seção que aparece nele.
invalidValue (400) playlistIsPrivate Uma ou mais das playlists especificadas são particulares e, portanto, não podem ser incluídas na seção do canal.
invalidValue (400) playlistsDuplicated A solicitação falhou porque especificou playlists duplicadas.
invalidValue (400) playlistsNeeded Se a propriedade snippet.type tiver um valor de singlePlaylist ou multiplePlaylists, a propriedade contentDetails.playlists[] precisará ser especificada.
invalidValue (400) playlistsNotExpected O recurso fornecido com a solicitação especificou um valor para a propriedade contentDetails.playlists[], mas não é esperado que playlists sejam usadas para esse tipo de seção do canal.
invalidValue (400) snippetNeeded É necessário especificar um snippet para atualizar a seção do canal.
invalidValue (400) titleLengthExceeded O valor da propriedade snippet.title é muito longo.
invalidValue (400) titleRequired Se a propriedade snippet.type tiver um valor de multiplePlaylists ou multipleChannels, defina o título da seção especificando um valor para a propriedade snippet.title.
notFound (404) channelNotFound Um ou mais dos canais especificados não foram encontrados.
notFound (404) channelSectionNotFound Não foi possível encontrar a seção do canal que você está tentando atualizar.
notFound (404) playlistNotFound Não foi possível encontrar uma ou mais das playlists especificadas.

canais

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

channels.list

Tipo de erro Detalhe do erro Descrição
badRequest (400) invalidCriteria É possível especificar no máximo um dos seguintes filtros:id, mySubscribers, categoryId, mine, managedByMe, forUsername. No caso de autenticação do proprietário do conteúdo usando o parâmetro onBehalfOfContentOwner, apenas id ou managedByMe podem ser especificados.
forbidden (403) channelForbidden O canal especificado pelo parâmetro id não é compatível com a solicitação ou a solicitação não está autorizada corretamente.
notFound (404) categoryNotFound Não foi possível encontrar a categoria identificada pelo parâmetro categoryId. Use o método guideCategories.list para recuperar uma lista de valores válidos.
notFound (404) channelNotFound Não foi possível encontrar o canal especificado no parâmetro id.

channels.update

Tipo de erro Detalhe do erro Descrição
badRequest (400) brandingValidationError Um dos valores no objeto brandingSettings falhou na validação. Use o método channels.list para recuperar as configurações atuais do canal e atualizar os valores da propriedade seguindo as diretrizes na documentação do recurso channels.
badRequest (400) channelTitleUpdateForbidden Ao atualizar o brandingSettings part de um canal, defina o valor da propriedade brandingSettings.channel.title como o título atual do canal ou omita a propriedade. A API vai retornar um erro se você mudar o valor da propriedade.
badRequest (400) defaultLanguageNotSetError O defaultLanguage precisa ser definido para atualizar localizations.
badRequest (400) invalidBrandingOption Uma das configurações de marca que você especificou não existe. Use o método channels.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso channels.
badRequest (400) invalidCustomMessage Os metadados da solicitação especificam uma mensagem personalizada inválida. Verifique o valor da propriedade invideoPromotion.items[].customMessage no recurso que a solicitação enviou.
badRequest (400) invalidDuration Os metadados da solicitação especificam uma duração inválida na parte "invideoPromotion".
badRequest (400) invalidDuration 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. Confira o valor da propriedade invideoPromotion.position.type no recurso que a solicitação enviou.
badRequest (400) invalidRecentlyUploadedBy Os metadados da solicitação especificam um ID de canal inválido. Verifique o valor da propriedade invideoPromotion.items[].id.recentlyUploadedBy no recurso que a solicitação enviou.
badRequest (400) invalidTimingOffset Os metadados da solicitação especificam um deslocamento de tempo inválido na parte invideoPromotion.
badRequest (400) 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 (400) 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. Confira o valor da propriedade invideoPromotion.timing.type no recurso que a solicitação enviou.
badRequest (400) localizationValidationError Um dos valores no objeto de localizações falhou na validação. Use o método channels.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso de canais.
badRequest (400) tooManyPromotedItems O número de itens promovidos permitidos foi excedido na parte "invideoPromotion".
forbidden (403) channelForbidden O canal especificado no parâmetro id não é compatível com a solicitação ou a solicitação não está autorizada corretamente.
forbidden (403) promotedVideoNotAllowed 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 garantir que o ID do canal esteja correto.
forbidden (403) websiteLinkNotAllowed O URL do site especificado não é permitido.
notFound (404) channelNotFound O canal especificado pelo parâmetro id não foi encontrado ou não tem opções de branding.
notFound (404) channelNotFound Não foi possível encontrar o canal especificado no parâmetro id.
notFound (404) unknownChannelId O ID do canal especificado não foi encontrado.
notFound (404) unknownChannelId O ID do canal especificado por recentlyUploadedBy não foi encontrado.
notFound (404) unknownVideoId O ID do vídeo especificado como um item promovido não pode ser encontrado.
required (400) requiredItemIdType Os metadados da solicitação precisam especificar um tipo de item na parte invideoPromotion.
required (400) requiredItemId Os metadados da solicitação precisam especificar um item na parte invideoPromotion.
required (400) requiredTimingOffset Os metadados da solicitação precisam especificar um deslocamento de tempo padrão para que o YouTube possa determinar quando exibir o item promovido. Defina o valor da propriedade invideoPromotion.defaultTiming.offsetMs no recurso que a solicitação envia.
required (400) 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 (400) 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.defaultTiming.type no recurso que a solicitação envia.
required (400) 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 (400) requiredTiming Os metadados da solicitação precisam especificar um tempo para cada item na parte invideoPromotion.
required (400) requiredVideoId Os metadados da solicitação devem especificar um ID de vídeo para identificar o item promovido.
required (400) requiredWebsiteUrl Os metadados da solicitação precisam especificar um URL do site na parte invideoPromotion. Defina o valor da propriedade invideoPromotion.items[].id.websiteUrl no recurso que a solicitação envia.

commentThreads

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos commentThreads. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

commentThreads.list

Tipo de erro Detalhe do erro Descrição
badRequest (400) operationNotSupported A solicitação à API é inválida ou foi formada incorretamente. Consequentemente, o servidor da API não identificou a solicitação.
badRequest (400) processingFailure O servidor da API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso commentThread no corpo da solicitação para garantir que ele seja válido.
forbidden (403) commentsDisabled O vídeo identificado pelo parâmetro videoId tem os comentários desativados.
forbidden (403) forbidden Não é possível recuperar uma ou mais das linhas de comentários solicitadas devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
notFound (404) channelNotFound Não foi possível encontrar o canal identificado pelo parâmetro allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound Não foi possível encontrar uma ou mais das conversas de comentários especificadas. Verifique os valores do parâmetro id da solicitação para garantir que ele esteja correto.
notFound (404) videoNotFound Não foi possível encontrar o vídeo identificado pelo parâmetro videoId.

commentThreads.insert

Tipo de erro Detalhe do erro Descrição
badRequest (400) channelOrVideoIdMissing Cada conversa precisa estar vinculada a um canal ou vídeo. Verifique se o recurso especifica valores para as propriedades snippet.channelId e snippet.videoId. Um comentário em um vídeo aparece na página de exibição do vídeo.
badRequest (400) commentTextRequired O recurso comment que está sendo inserido precisa especificar um valor para a propriedade snippet.topLevelComment.snippet.textOriginal. Os comentários não podem ficar em branco.
badRequest (400) commentTextTooLong O recurso comment que está sendo inserido contém muitos caracteres na propriedade snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Os metadados da solicitação são inválidos.
badRequest (400) processingFailure O servidor da API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso commentThread no corpo da solicitação para garantir que ele seja válido.
forbidden (403) forbidden A linha de execução de comentários pode ter sido criada devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
forbidden (403) ineligibleAccount A conta do YouTube usada para autorizar a solicitação da API precisa ser mesclada à Conta do Google do usuário para inserir um comentário ou uma conversa.
notFound (404) channelNotFound Não foi possível encontrar o canal especificado. Verifique o valor da propriedade snippet.channelId para garantir que ele está correto.
notFound (404) videoNotFound Não foi possível encontrar o vídeo especificado. Verifique o valor da propriedade snippet.videoId para garantir que ele está correto.

comentários

O método comments.markAsSpam não é mais compatível.

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos comments. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

comments.list

Tipo de erro Detalhe do erro Descrição
badRequest (400) operationNotSupported A solicitação à API é inválida ou foi formada incorretamente. Consequentemente, o servidor da API não identificou a solicitação.
forbidden (403) forbidden Um ou mais dos comentários solicitados não podem ser recuperados devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
notFound (404) commentNotFound Um ou mais dos comentários especificados não podem ser encontrados. Verifique os valores dos parâmetros id e parentId da solicitação para garantir que eles estejam corretos.

comments.setModerationStatus

Tipo de erro Detalhe do erro Descrição
badRequest (400) banWithoutReject O parâmetro banAuthor só pode ser usado se o valor do parâmetro moderationStatus for rejected.
badRequest (400) operationNotSupported A solicitação à API é inválida ou foi formada incorretamente. Consequentemente, o servidor da API não identificou a solicitação.
badRequest (400) processingFailure O servidor da API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida.
forbidden (403) forbidden Não é possível definir o status de moderação de um ou mais comentários devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
notFound (404) commentNotFound Um ou mais comentários que a solicitação está tentando atualizar não podem ser encontrados. Verifique os valores do parâmetro id da solicitação para garantir que eles estejam corretos.

comments.insert

Tipo de erro Detalhe do erro Descrição
badRequest (400) commentTextRequired O recurso comment que está sendo inserido precisa especificar um valor para a propriedade snippet.textOriginal. Os comentários não podem ficar em branco.
badRequest (400) commentTextTooLong O recurso comment que está sendo inserido contém muitos caracteres na propriedade snippet.textOriginal.
badRequest (400) invalidCommentMetadata Os metadados da solicitação são inválidos.
badRequest (400) operationNotSupported O usuário da API não pode inserir um comentário em resposta ao comentário de nível superior identificado pela propriedade snippet.parentId. Em um recurso commentThread, a propriedade snippet.canReply indica se o espectador atual pode responder à conversa.
badRequest (400) parentCommentIsPrivate O comentário pai especificado é particular. A API não oferece suporte a respostas a comentários privados.
badRequest (400) parentIdMissing O comentário que está sendo inserido precisa estar vinculado a um comentário pai. No entanto, o recurso comment no corpo da solicitação da API não especificou um valor para a propriedade snippet.parentId.
badRequest (400) processingFailure O servidor da API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso comment no corpo da solicitação para garantir que ele seja válido.
forbidden (403) forbidden Não é possível criar o comentário porque você não tem as permissões necessárias. A solicitação pode não es devidamente autorizada.
forbidden (403) ineligibleAccount A conta do YouTube usada para autorizar a solicitação da API precisa ser mesclada à Conta do Google do usuário para inserir um comentário ou uma conversa.
notFound (404) parentCommentNotFound Não foi possível encontrar o comentário pai especificado. Verifique o valor da propriedade snippet.parentId no corpo da solicitação para garantir que ele está correto.

comments.delete

Tipo de erro Detalhe do erro Descrição
badRequest (400) processingFailure O servidor da API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida.
forbidden (403) forbidden Não foi possível excluir o comentário devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
notFound (404) commentNotFound Não foi possível encontrar o comentário especificado. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

comments.update

Tipo de erro Detalhe do erro Descrição
badRequest (400) commentTextTooLong O recurso comment que está sendo atualizado contém muitos caracteres na propriedade snippet.textOriginal.
badRequest (400) invalidCommentMetadata Os metadados da solicitação são inválidos.
badRequest (400) operationNotSupported A solicitação à API é inválida ou foi formada incorretamente. Consequentemente, o servidor da API não identificou a solicitação.
badRequest (400) processingFailure O servidor da API não conseguiu processar a solicitação. Embora esse possa ser um erro temporário, ele geralmente indica que a entrada da solicitação é inválida. Verifique a estrutura do recurso comment no corpo da solicitação para garantir que ele seja válido.
forbidden (403) forbidden Não foi possível atualizar o comentário porque você não tem permissões suficientes. A solicitação pode não es devidamente autorizada.
forbidden (403) ineligibleAccount A conta do YouTube usada para autorizar a solicitação da API precisa ser mesclada à Conta do Google do usuário para atualizar um comentário ou uma conversa.
notFound (404) commentNotFound Não foi possível encontrar o comentário especificado. Verifique o valor da propriedade id no corpo da solicitação para garantir que ele está correto.

membros

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos members. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

members.list

Tipo de erro Detalhe do erro Descrição
badRequest (400) channelMembershipsNotEnabled O canal do criador de conteúdo que autorizou a solicitação não tem os Clubes dos canais ativados.
badRequest (400) invalidMode O valor do parâmetro mode é inválido. Esse erro pode ocorrer se o parâmetro pageToken especificar um token que foi recuperado usando um modo diferente do especificado.
badRequest (400) invalidPageToken O valor do parâmetro pageToken é inválido. Esse erro ocorre se o token da página usado na solicitação tiver expirado.
badRequest (400) invalidHasAccessToLevel O valor do parâmetro hasAccessToLevel é inválido. Não há nível com o id especificado.
badRequest (400) invalidFilterByMemberChannelId O valor do parâmetro filterByMemberChannelId é inválido. Esse erro ocorre se o valor do parâmetro filterByMemberChannelId especificar mais de 100 canais.

membershipsLevels

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos members. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

membershipsLevels.list

Tipo de erro Detalhe do erro Descrição
badRequest (400) channelMembershipsNotEnabled O canal do criador de conteúdo que autorizou a solicitação não tem os Clubes dos canais ativados.

playlistItems

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

playlistItems.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) playlistItemsNotAccessible A solicitação não está devidamente autorizada a excluir o item da playlist especificado.
notFound (404) playlistItemNotFound Não foi possível encontrar o item da playlist identificado com o parâmetro id da solicitação.
invalidValue (400) playlistOperationUnsupported A API não oferece suporte para a exclusão de vídeos da playlist especificada. Por exemplo, não é possível excluir um vídeo da playlist de vídeos enviados.

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 (403) playlistContainsMaximumNumberOfVideos A playlist já contém o número máximo permitido de itens.
forbidden (403) playlistItemsNotAccessible A solicitação não está autorizada corretamente para inserir o item de playlist especificado.
invalidValue (400) invalidContentDetails A propriedade contentDetails na solicitação não é válida. Uma possível razão é que o campo contentDetails.note tem mais de 280 caracteres.
invalidValue (400) 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 (400) invalidResourceType O type especificado para o ID do recurso não é compatível com essa operação. O ID do recurso identifica o item que está sendo adicionado à playlist, como youtube#video.
invalidValue (400) manualSortRequired A solicitação tenta definir a posição do item da playlist, mas ela não usa a classificação manual. Por exemplo, os itens da playlist podem ser classificados por data ou popularidade. Para resolver o erro, remova o elemento snippet.position do recurso que a solicitação está inserindo. Se você quiser que o item da playlist tenha uma posição específica na lista, primeiro atualize a opção Ordem da playlist para Manual nas configurações dela. Essas configurações podem ser ajustadas no Gerenciador de vídeos do YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist O vídeo que você está tentando adicionar já está em outra playlist em série.
invalidValue (400) playlistOperationUnsupported A API não oferece suporte para inserir vídeos na playlist especificada. Por exemplo, não é possível inserir um vídeo na playlist de vídeos enviados.
notFound (404) playlistNotFound Não foi possível encontrar a playlist identificada com o parâmetro playlistId da solicitação.
notFound (404) videoNotFound O vídeo que você está tentando adicionar à playlist não pode ser encontrado. Verifique se o valor da propriedade videoId está correto.
required (400) channelIdRequired A solicitação não especifica um valor para a propriedade channelId obrigatória.
required (400) playlistIdRequired A solicitação não especifica um valor para a propriedade playlistId obrigatória.
required (400) resourceIdRequired A solicitação precisa conter um recurso em que o objeto snippet especifique um resourceId.

playlistItems.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) playlistItemsNotAccessible A solicitação não está devidamente autorizada a recuperar a playlist especificada.
notFound (404) playlistNotFound Não foi possível encontrar a playlist identificada com o parâmetro playlistId da solicitação.
notFound (404) videoNotFound Não foi possível encontrar o vídeo identificado com o parâmetro videoId da solicitação.
required (400) playlistIdRequired A solicitação de inscrição não especifica um valor para a propriedade playlistId obrigatória.
invalidValue (400) playlistOperationUnsupported A API não oferece suporte para listar vídeos na playlist especificada. Por exemplo, não é possível adicionar um vídeo à playlist "Assistir mais tarde".

playlistItems.update

Tipo de erro Detalhe do erro Descrição
forbidden (403) playlistItemsNotAccessible A solicitação não está autorizada corretamente para atualizar o item de playlist especificado.
invalidValue (400) 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 (400) invalidResourceType O type especificado para o ID do recurso não é compatível com essa operação. O ID do recurso identifica o item que está sendo adicionado à playlist, como youtube#video.
invalidValue (400) invalidSnippet A solicitação não especifica uma propriedade snippet válida.
invalidValue (400) manualSortRequired A solicitação tenta definir a posição do item da playlist, mas ela não usa a classificação manual. Por exemplo, os itens da playlist podem ser classificados por data ou popularidade. Para resolver o erro, remova o elemento snippet.position do recurso que a solicitação está inserindo. Se você quiser que o item da playlist tenha uma posição específica na lista, primeiro atualize a opção Ordem da playlist para Manual nas configurações dela. Essas configurações podem ser ajustadas no Gerenciador de vídeos do YouTube.
invalidValue (400) playlistOperationUnsupported A API não oferece suporte à atualização de vídeos na playlist especificada. Por exemplo, não é possível atualizar um vídeo na playlist de vídeos enviados.
notFound (404) playlistItemNotFound Não foi possível encontrar o item da playlist identificado com a propriedade id da solicitação.
notFound (404) playlistNotFound Não foi possível encontrar a playlist identificada com o parâmetro playlistId da solicitação.
required (400) channelIdRequired A solicitação não especifica um valor para a propriedade channelId obrigatória.
required (400) playlistIdRequired A solicitação não especifica um valor para a propriedade playlistId obrigatória.
required (400) playlistItemIdRequired O recurso de item de playlist especificado na solicitação precisa usar a propriedade id para identificar o item de playlist que está sendo atualizado.

playlists

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

playlists.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) playlistForbidden Essa operação é proibida ou a solicitação não está autorizada corretamente.
notFound (404) playlistNotFound Não foi possível encontrar a playlist identificada com o parâmetro id da solicitação.
invalidValue (400) playlistOperationUnsupported A API não oferece suporte para a exclusão da playlist especificada. Por exemplo, não é possível excluir a playlist de vídeos enviados.

playlists.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) channelClosed O canal especificado no parâmetro channelId foi fechado.
forbidden (403) channelSuspended O canal especificado no parâmetro channelId foi suspenso.
forbidden (403) playlistForbidden A playlist identificada com o parâmetro id da solicitação não é compatível com a solicitação ou não está autorizada corretamente.
notFound (404) channelNotFound Não foi possível encontrar o canal especificado no parâmetro channelId.
notFound (404) playlistNotFound Não foi possível encontrar a playlist identificada com o parâmetro id da solicitação.
invalidValue (400) playlistOperationUnsupported A API não oferece suporte para listar a playlist especificada. Por exemplo, não é possível listar a playlist "Assistir mais tarde".

playlists.insert

Tipo de erro Detalhe do erro Descrição
badRequest (400) defaultLanguageNotSetError O defaultLanguage precisa ser definido para atualizar localizations.
badRequest (400) localizationValidationError Um dos valores no objeto de localizações falhou na validação. Use o método playlists.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso de playlists.
badRequest (400) maxPlaylistExceeded Não é possível criar a playlist porque o canal já tem o número máximo de playlists permitido.
forbidden (403) playlistForbidden Essa operação é proibida ou a solicitação não está autorizada corretamente.
invalidValue (400) invalidPlaylistSnippet A solicitação fornece um snippet de playlist inválido.
required (400) playlistTitleRequired A solicitação deve especificar um título da playlist.

playlists.update

Tipo de erro Detalhe do erro Descrição
badRequest (400) defaultLanguageNotSetError O defaultLanguage precisa ser definido para atualizar localizations.
badRequest (400) localizationValidationError Um dos valores no objeto de localizações falhou na validação. Use o método playlists.list para extrair valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso de playlists.
forbidden (403) playlistForbidden Essa operação é proibida ou a solicitação não está autorizada corretamente.
invalidValue (400) invalidPlaylistSnippet A solicitação fornece um snippet de playlist inválido.
invalidValue (400) playlistOperationUnsupported A API não oferece suporte para atualizar a playlist especificada. Por exemplo, não é possível atualizar as propriedades da playlist de vídeos enviados.
notFound (404) playlistNotFound Não foi possível encontrar a playlist identificada com o parâmetro id da solicitação.
required (400) playlistTitleRequired A solicitação deve especificar um título da playlist.

assinaturas

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

subscriptions.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) subscriptionForbidden A solicitação não está devidamente autenticada ou não é suportada para este canal.
notFound (404) 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 (400) subscriptionDuplicate A inscrição que você está tentando criar já existe.
badRequest (400) subscriptionForbidden Você atingiu o número máximo de assinaturas.
badRequest (400) subscriptionForbidden Muitas inscrições recentes. Tente novamente em algumas horas.
badRequest (400) subscriptionForbidden Não é possível se inscrever no seu próprio canal.
forbidden (403) subscriptionForbidden A solicitação não está devidamente autenticada ou não é suportada para este canal.
notFound (404) publisherNotFound O recurso especificado pela propriedade snippet.resourceId da solicitação não foi encontrado.
notFound (404) subscriberNotFound O assinante identificado com a solicitação não pode ser encontrado.
required (400) publisherRequired O recurso de assinatura especificado na solicitação precisa usar a propriedade snippet.resourceId para identificar o canal em que a assinatura está sendo feita.

subscriptions.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) accountClosed Não foi possível recuperar as assinaturas porque a conta do assinante está encerrada.
forbidden (403) accountSuspended Não foi possível recuperar as assinaturas porque a conta do assinante está suspensa.
forbidden (403) subscriptionForbidden O solicitante não tem permissão para acessar as assinaturas solicitadas.
notFound (404) subscriberNotFound O assinante identificado com a solicitação não pode ser encontrado.

miniaturas

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

thumbnails.set

Tipo de erro Detalhe do erro Descrição
badRequest (400) invalidImage O conteúdo da imagem fornecido é inválido.
badRequest (400) mediaBodyRequired A solicitação não inclui o conteúdo da imagem.
forbidden (403) forbidden A miniatura não pode ser configurada para o vídeo especificado. A solicitação pode não es devidamente autorizada.
forbidden (403) forbidden O usuário autenticado não tem permissões para carregar e configurar miniaturas de vídeo personalizadas.
notFound (404) 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.
tooManyRequests (429) uploadRateLimitExceeded O canal enviou muitas miniaturas recentemente. Tente fazer a solicitação mais tarde.

videoAbuseReportReasons

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos videoAbuseReportReasons. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

videoAbuseReportReasons.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Acesso proibido. A solicitação não pode ser devidamente autorizada.

videoCategories

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

videoCategories.list

Tipo de erro Detalhe do erro Descrição
notFound (404) videoCategoryNotFound Não foi possível encontrar a categoria de vídeo identificada pelo parâmetro id. Use o método videoCategories.list para recuperar uma lista de valores válidos.

vídeos

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

videos.insert

Tipo de erro Detalhe do erro Descrição
badRequest (400) defaultLanguageNotSet A solicitação está tentando adicionar detalhes de vídeo localizados sem especificar o idioma padrão.
badRequest (400) invalidCategoryId A propriedade snippet.categoryId especifica um ID de categoria inválido. Use o método videoCategories.list para recuperar as categorias compatíveis.
badRequest (400) invalidDescription Os metadados da solicitação especificam uma descrição de vídeo inválida.
badRequest (400) invalidFilename O nome do arquivo de vídeo especificado no cabeçalho Slug é inválido.
badRequest (400) invalidPublishAt Os metadados da solicitação especificam um horário de publicação programado inválido.
badRequest (400) invalidRecordingDetails O objeto recordingDetails nos metadados da solicitação especifica detalhes de gravação inválidos.
badRequest (400) invalidTags Os metadados da solicitação especificam palavras-chave de vídeo inválidas.
badRequest (400) invalidTitle Os metadados da solicitação especificam um título de vídeo inválido ou vazio.
badRequest (400) invalidVideoGameRating Os metadados da solicitação especificam uma classificação de video game inv.
badRequest (400) invalidVideoMetadata Os metadados da solicitação são inválidos. Esse erro ocorre se a solicitação atualizar a parte snippet de um recurso video, mas não definir um valor para as propriedades snippet.title e snippet.categoryId.
badRequest (400) mediaBodyRequired A solicitação não inclui o conteúdo da vídeo.
badRequest (400) uploadLimitExceeded O usuário excedeu o número de vídeos que pode enviar.
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting A solicitação tenta definir uma licença inválida para o vídeo.
forbidden (403) 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 (400) videoChartNotFound O gráfico de vídeo solicitado não é suportado ou não está disponível.
forbidden (403) forbidden A solicitação não está autorizada corretamente para acessar arquivos de vídeo ou informações de processamento. As partes fileDetails, processingDetails e suggestions só estão disponíveis para o proprietário do vídeo.
forbidden (403) forbidden A solicitação não pode acessar informações de avaliação do usuário. Esse erro pode ocorrer porque a solicitação não está autorizada corretamente para usar o parâmetro myRating.
notFound (404) videoNotFound Não foi possível encontrar o vídeo que você está tentando recuperar. Verifique o valor do parâmetro id da solicitação para garantir que ele esteja correto.

videos.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden O vídeo que você está tentando excluir não pode ser excluíd A solicitação pode nãoser devidamente autorizada.
notFound (404) 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 (400) defaultLanguageNotSet A solicitação da API está tentando adicionar detalhes de vídeo localizados sem especificar o idioma padrão dos detalhes do vídeo.
badRequest (400) invalidCategoryId A propriedade snippet.categoryId especifica um ID de categoria inválido. Use o método videoCategories.list para recuperar as categorias compatíveis.
badRequest (400) invalidDefaultBroadcastPrivacySetting A solicitação tenta definir uma configuração de privacidade inválida para a transmissão padrão.
badRequest (400) invalidDescription Os metadados da solicitação especificam uma descrição de vídeo inválida.
badRequest (400) invalidPublishAt Os metadados da solicitação especificam um horário de publicação programado inválido.
badRequest (400) invalidRecordingDetails O objeto recordingDetails nos metadados da solicitação especifica detalhes de gravação inválidos.
badRequest (400) invalidTags Os metadados da solicitação especificam palavras-chave de vídeo inválidas.
badRequest (400) invalidTitle Os metadados da solicitação especificam um título de vídeo inválido ou vazio.
badRequest (400) invalidVideoMetadata Os metadados da solicitação são inválidos. Esse erro ocorre se a solicitação atualizar a parte snippet de um recurso video, mas não definir um valor para as propriedades snippet.title e snippet.categoryId.
forbidden (403) forbidden Acesso proibido. A solicitação não pode ser devidamente autorizada.
forbidden (403) forbiddenEmbedSetting A solicitação tenta definir uma configuração de incorporação inválida para o vídeo. Alguns canais podem não ter permissão para oferecer players incorporados para transmissões ao vivo. Consulte a Central de Ajuda do YouTube para mais informações.
forbidden (403) forbiddenLicenseSetting A solicitação tenta definir uma licença inválida para o vídeo.
forbidden (403) forbiddenPrivacySetting A solicitação tenta definir uma configuração de privacidade inválida para o vídeo.
notFound (404) 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 está correto.

videos.rate

Tipo de erro Detalhe do erro Descrição
badRequest (400) emailNotVerified O usuário precisa verificar o endereço de e-mail antes de avaliar.
badRequest (400) invalidRating A solicitação continha um valor inesperado para o parâmetro rating.
badRequest (400) videoPurchaseRequired Os vídeos de aluguel só podem ser avaliados pelos usuários que os alugaram.
forbidden (403) forbidden O vídeo que você está tentando classificar não pode ser classificado. A solicitação pode não es devidamente autorizada.
forbidden (403) videoRatingDisabled O proprietário do vídeo que você está tentando classificar desativou as classificações.
notFound (404) 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.

videos.reportAbuse

Tipo de erro Detalhe do erro Descrição
badRequest (400) invalidAbuseReason A solicitação continha um valor inesperado para o campo reason_id ou uma combinação dos campos reason_id e secondary_reason_id.
badRequest (400) rateLimitExceeded O usuário enviou muitas solicitações em um determinado período.
forbidden (403) forbidden
notFound (404) videoNotFound Não foi possível encontrar o vídeo que você está tentando denunciar.

coloca marca-d'água

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos watermarks. Esses métodos também podem retornar erros listados na seção Erros de solicitação comuns.

watermarks.set

Tipo de erro Detalhe do erro Descrição
badRequest (400) imageFormatUnsupported A imagem que você forneceu está em um formato não suportado.
badRequest (400) imageTooTall A imagem que você forneceu é muito alta.
badRequest (400) imageTooWide A imagem que você forneceu é muito grande.
badRequest (400) mediaBodyRequired A solicitação não inclui o conteúdo da imagem.
forbidden (403) forbidden A marca d'água não pode ser definida para o canal especificado. A solicitação pode não estar autorizada corretamente ou o parâmetro channelId pode estar definido como um valor inválido.

watermarks.unset

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden A marca d'água não pode ser não definida para o canal especificado. A solicitação pode não estar autorizada corretamente ou o parâmetro channelId pode estar definido como um valor inválido.