O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.
YouTube Data API - Errors
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, identificamos os diferentes tipos de erros que as operações do 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 de API que não são específicas de um método de API específico.
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, defina também 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 do OAuth 2.0 fornecido para a solicitação especifica escopos insuficientes para acessar os dados solicitados. |
notFound (404) |
contentOwnerAccountNotFound |
A conta de proprietário do conteúdo especificada não foi encontrada. |
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, autentique-se 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 de 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 não aceito. |
unauthorized (401) |
authorizationRequired |
A solicitação usa o parâmetro mine, mas não está devidamente autorizada. |
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 do 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 certamente tem uma Conta do Google, mas talvez ainda não tenha vinculado essa conta a um canal do YouTube.
Esse erro é comum quando você tenta usar o fluxo de conta de serviço do OAuth 2.0. O YouTube não é compatível com contas de serviço. Se você tentar autenticar usando uma conta de serviço, vai receber esse erro.
A postagem do blog da API YouTube que apresenta o suporte à Conta do Google também discute o erro youtubeSignupRequired em 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
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos activities. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 por essa 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á devidamente autorizada. |
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 no momento. |
unauthorized (401) |
authorizationRequired |
A solicitação usa o parâmetro home, mas não está devidamente autorizada. |
legendas
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos captions. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 solicitado. 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 os valores snippet.language e snippet.name informados. 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 resolver 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 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 aceitável é 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 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 faixas de legenda que não existem ou IDs de faixas associados a outros vídeos. Verifique os valores dos parâmetros id e videoId da solicitação para garantir que 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 enviou 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 aos recursos channelBanners. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
channelBanners.insert
| Tipo de erro |
Detalhe do erro |
Descrição |
badRequest (400) |
bannerAlbumFull |
O álbum "Arte do canal do YouTube" tem muitas imagens. Acesse http://photos.google.com, navegue até a página de álbuns e remova algumas imagens do álbum em questão. |
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 aos recursos channelSections. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso 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 recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso channelSections. |
badRequest (400) |
targetInvalidLanguage |
Um dos valores na lista targeting.languages falhou na validação. Use o método channelSections.list para recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso channelSections. |
badRequest (400) |
targetInvalidRegion |
Um dos valores na lista targeting.regions falhou na validação. Use o método channelSections.list para recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso 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 os canais não são esperados para esse tipo de seção de canal. |
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 |
Não é possível concluir a solicitação 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 próprio canal em uma seção que aparece nele. |
invalidValue (400) |
playlistIsPrivate |
Uma ou mais playlists especificadas são privadas e, por isso, 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 as playlists não são esperadas para esse tipo de seção do canal. |
invalidValue (400) |
snippetNeeded |
É necessário 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 |
Não foi possível encontrar um ou mais canais especificados. |
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 |
Não foi possível concluir a solicitação 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 |
A seção do canal associada à solicitação não foi encontrada. |
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 recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso 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 recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso channelSections. |
badRequest (400) |
targetInvalidLanguage |
Um dos valores na lista targeting.languages falhou na validação. Use o método channelSections.list para recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso channelSections. |
badRequest (400) |
targetInvalidRegion |
Um dos valores na lista targeting.regions falhou na validação. Use o método channelSections.list para recuperar valores válidos e atualizá-los seguindo as diretrizes na documentação do recurso 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 os canais não são esperados para esse tipo de seção de canal. |
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 próprio canal em uma seção que aparece nele. |
invalidValue (400) |
playlistIsPrivate |
Uma ou mais playlists especificadas são privadas e, por isso, 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 as playlists não são esperadas para esse tipo de seção do canal. |
invalidValue (400) |
snippetNeeded |
É preciso 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 |
Não foi possível encontrar um ou mais canais especificados. |
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 aos recursos channels. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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, somente 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 ela não está devidamente autorizada. |
notFound (404) |
categoryNotFound |
Não foi possível encontrar a categoria identificada pelo parâmetro categoryId. |
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 atualize os valores das propriedades seguindo as diretrizes na documentação do recurso channels. |
badRequest (400) |
channelTitleUpdateForbidden |
Ao atualizar o brandingSettings part de um canal, você precisa definir o valor da propriedade brandingSettings.channel.title como o título atual do canal ou omitir 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 recuperar valores válidos e atualize-os 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 enviado pela solicitação. |
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. Verifique o valor da propriedade invideoPromotion.position.type no recurso enviado pela solicitação. |
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 enviado pela solicitação. |
badRequest (400) |
invalidTimingOffset |
Os metadados da solicitação especificam um ajuste de tempo inválido na parte invideoPromotion. |
badRequest (400) |
invalidTimingOffset |
Os metadados da solicitação especificam um ajuste 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.offsetMs no recurso enviado pela solicitação. |
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. Verifique o valor da propriedade invideoPromotion.timing.type no recurso enviado pela solicitação. |
badRequest (400) |
localizationValidationError |
Um dos valores no objeto de localizações não foi validado. Use o método channels.list para recuperar valores válidos e atualize-os 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 ela não está devidamente autorizada. |
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 recentlyUploadedBy especificado 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 ajuste de tempo padrão para que o YouTube possa determinar quando mostrar o item promovido. Defina o valor da propriedade invideoPromotion.defaultTiming.offsetMs no recurso enviado pela solicitação. |
required (400) |
requiredTimingOffset |
Os metadados da solicitação precisam especificar um ajuste de tempo para que o YouTube possa determinar quando mostrar o item promovido. Defina o valor da propriedade invideoPromotion.timing.offsetMs no recurso enviado pela solicitação. |
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 enviado pela solicitação. |
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 enviado pela solicitação. |
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 enviado pela solicitação. |
membros
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos members. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
members.list
| Tipo de erro |
Detalhe do erro |
Descrição |
badRequest (400) |
channelMembershipsNotEnabled |
O canal do criador de conteúdo que autoriza o pedido 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 de 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 de 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 aos recursos members. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
membershipsLevels.list
| Tipo de erro |
Detalhe do erro |
Descrição |
badRequest (400) |
channelMembershipsNotEnabled |
O canal do criador de conteúdo que autoriza o pedido 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 aos recursos playlistItems. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 permite excluir 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á devidamente autorizada para inserir o item de playlist especificado. |
invalidValue (400) |
invalidContentDetails |
A propriedade contentDetails na solicitação não é válida. Um possível motivo é 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 esta 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 a playlist 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 tenha uma posição específica na lista, primeiro atualize a opção Ordenação da playlist para Manual nas configurações dela. Essa configuração pode ser ajustada no Gerenciador de vídeos do YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
O vídeo que você está tentando adicionar à playlist já está em outra playlist em série. |
invalidValue (400) |
playlistOperationUnsupported |
A API não permite 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 |
A playlist identificada com o parâmetro playlistId da solicitação não foi encontrada. |
notFound (404) |
videoNotFound |
O vídeo que você está tentando adicionar à playlist não pode ser encontrado. Verifique o valor da propriedade videoId para garantir que esteja correto. |
required (400) |
channelIdRequired |
A solicitação não especifica um valor para a propriedade obrigatória channelId. |
required (400) |
playlistIdRequired |
A solicitação não especifica um valor para a propriedade obrigatória playlistId. |
required (400) |
resourceIdRequired |
A solicitação precisa conter um recurso em que o objeto snippet especifica 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 |
A playlist identificada com o parâmetro playlistId da solicitação não foi encontrada. |
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 obrigatória playlistId. |
invalidValue (400) |
playlistOperationUnsupported |
A API não permite listar vídeos na playlist especificada. Por exemplo, não é possível listar um vídeo na playlist "Assistir mais tarde". |
playlistItems.update
| Tipo de erro |
Detalhe do erro |
Descrição |
forbidden (403) |
playlistItemsNotAccessible |
A solicitação não está devidamente autorizada 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 esta 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 a playlist 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 tenha uma posição específica na lista, primeiro atualize a opção Ordenação da playlist para Manual nas configurações dela. Essa configuração pode ser ajustada no Gerenciador de vídeos do YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
A API não permite atualizar 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 |
A playlist identificada com o parâmetro playlistId da solicitação não foi encontrada. |
required (400) |
channelIdRequired |
A solicitação não especifica um valor para a propriedade obrigatória channelId. |
required (400) |
playlistIdRequired |
A solicitação não especifica um valor para a propriedade obrigatória playlistId. |
required (400) |
playlistItemIdRequired |
O recurso de item de playlist especificado na solicitação precisa usar a propriedade id para identificar o item que está sendo atualizado. |
playlists
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos playlists. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
playlists.delete
| Tipo de erro |
Detalhe do erro |
Descrição |
forbidden (403) |
playlistForbidden |
A operação é proibida ou a solicitação não está devidamente autorizada. |
notFound (404) |
playlistNotFound |
A playlist identificada com o parâmetro id da solicitação não foi encontrada. |
invalidValue (400) |
playlistOperationUnsupported |
A API não permite excluir a 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 a solicitação não está devidamente autorizada. |
notFound (404) |
channelNotFound |
Não foi possível encontrar o canal especificado no parâmetro channelId. |
notFound (404) |
playlistNotFound |
A playlist identificada com o parâmetro id da solicitação não foi encontrada. |
invalidValue (400) |
playlistOperationUnsupported |
A API não permite listar a playlist especificada. Por exemplo, não é possível listar sua 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 não foi validado. Use o método playlists.list para recuperar valores válidos e atualize-os 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 |
A operação é proibida ou a solicitação não está devidamente autorizada. |
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 não foi validado. Use o método playlists.list para recuperar valores válidos e atualize-os seguindo as diretrizes na documentação do recurso de playlists. |
forbidden (403) |
playlistForbidden |
A operação é proibida ou a solicitação não está devidamente autorizada. |
invalidValue (400) |
invalidPlaylistSnippet |
A solicitação fornece um snippet de playlist inválido. |
invalidValue (400) |
playlistOperationUnsupported |
A API não permite atualizar a playlist especificada. Por exemplo, não é possível atualizar as propriedades da playlist de vídeos enviados. |
notFound (404) |
playlistNotFound |
A playlist identificada com o parâmetro id da solicitação não foi encontrada. |
required (400) |
playlistTitleRequired |
A solicitação deve especificar um título da playlist. |
postagens
O recurso
posts e os métodos dele estão em uma fase piloto com acesso limitado a parceiros de lançamento selecionados (projetos aprovados do Google Cloud). O acesso mais amplo à API pública está planejado para disponibilidade geral em 2027.
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos posts. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
posts.delete
| Tipo de erro |
Detalhe do erro |
Descrição |
invalidValue (400) |
invalidMetadata |
O ID do post é obrigatório. Especifique um ID de post válido no parâmetro id. |
forbidden (403) |
forbidden |
O autor da chamada não tem permissão para excluir esta postagem. Verifique se o usuário autenticado é o proprietário do canal ou tem permissão para gerenciar as postagens dele. |
notFound (404) |
postNotFound |
O post especificado não foi encontrado. Verifique se o ID da postagem no parâmetro id existe e não foi excluído. |
internalError (500) |
internalError |
Ocorreu um erro interno ao excluir o post. Tente fazer a solicitação novamente. |
posts.imageUpload
| Tipo de erro |
Detalhe do erro |
Descrição |
invalidValue (400) |
invalidMetadata |
A solicitação contém valores de metadados inválidos. Esse erro ocorre se o parâmetro channelId estiver ausente ou vazio, se o conteúdo da imagem enviada não puder ser decodificado, se o formato do arquivo não for compatível (os formatos compatíveis são JPEG, PNG, GIF e WebP) ou se a proporção da imagem não estiver entre 2:5 e 5:2. |
forbidden (403) |
forbidden |
A solicitação não está devidamente autorizada. Verifique se o usuário autenticado é o proprietário do canal especificado no parâmetro channelId ou se tem permissão para criar postagens nele. |
internalError (500) |
internalError |
Erro interno encontrado. Esse erro ocorre se a solicitação de upload não incluir o payload de mídia da imagem ou se o servidor não processar ou armazenar a imagem enviada. Verifique se o arquivo de imagem está incluído no corpo da solicitação e tente fazer o upload novamente. |
posts.insert
| Tipo de erro |
Detalhe do erro |
Descrição |
invalidValue (400) |
invalidMetadata |
A solicitação contém valores de metadados inválidos. Esse erro ocorre se o corpo da solicitação não tiver o recurso post ou snippet.channelId, omitir snippet.textDisplay e attachments.imageAttachments[], incluir um anexo de imagem com um uploadToken vazio, incluir mais de 10 imagens ou tiver texto inválido. Esse erro também ocorre se o canal não estiver qualificado para criar posts. |
invalidValue (400) |
invalidImageUploadToken |
O token da imagem enviada é inválido, expirou ou foi gerado para outro canal. Faça upload da imagem novamente para o canal de destino com posts.imageUpload e use o novo token. |
forbidden (403) |
forbidden |
A solicitação não está devidamente autorizada. Verifique se o usuário autenticado é o proprietário do canal especificado em snippet.channelId ou se tem permissão para criar postagens nele. |
rateLimitExceeded (403) |
rateLimitExceeded |
Não é possível concluir a solicitação porque você excedeu o limite de taxa para criar postagens no canal. Limite a taxa de solicitação e tente novamente com a espera exponencial. |
notFound (404) |
channelNotFound |
O canal especificado não foi encontrado. Verifique se o ID do canal em snippet.channelId existe e está ativo. |
internalError (500) |
internalError |
Ocorreu um erro interno ao criar o post. Tente fazer a solicitação novamente. |
posts.list
| Tipo de erro |
Detalhe do erro |
Descrição |
invalidValue (400) |
invalidMetadata |
A solicitação contém valores de metadados inválidos. Esse erro ocorre se o parâmetro channelId estiver vazio ou se o parâmetro maxResults não for um número inteiro entre 1 e 50, inclusive. Se uma solicitação não especificar o parâmetro channelId nem postId, a API vai retornar um erro missingRequiredParameter. Se uma solicitação especificar os dois parâmetros, a API vai retornar um erro incompatibleParameters. |
forbidden (403) |
forbidden |
A solicitação não está devidamente autorizada para listar postagens no canal especificado. |
rateLimitExceeded (403) |
rateLimitExceeded |
Não foi possível concluir a solicitação porque você excedeu o limite de taxa. Limite a taxa de solicitação e tente novamente com a espera exponencial. |
notFound (404) |
channelNotFound |
O canal especificado não foi encontrado. Verifique se o ID do canal no parâmetro channelId está correto. |
internalError (500) |
internalError |
Erro interno ao recuperar as postagens. Tente fazer a solicitação novamente. |
posts.update
| Tipo de erro |
Detalhe do erro |
Descrição |
invalidValue (400) |
invalidMetadata |
A solicitação contém valores de metadados inválidos. Verifique se o corpo da solicitação inclui um recurso post com valores válidos de id e snippet.textDisplay. |
forbidden (403) |
forbidden |
A solicitação não está devidamente autorizada. Verifique se o usuário autenticado é o proprietário do canal ou tem permissão para atualizar as postagens dele. |
rateLimitExceeded (403) |
rateLimitExceeded |
Não é possível concluir a solicitação porque você excedeu o limite de taxa para editar posts no canal. Limite a taxa de solicitação e tente novamente com a espera exponencial. |
notFound (404) |
postNotFound |
O post especificado não foi encontrado. Verifique se o ID da postagem na propriedade id existe e não foi excluído. |
internalError (500) |
internalError |
Ocorreu um erro interno ao atualizar o post. Tente fazer a solicitação novamente. |
pesquisar
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos search. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
search.list
| Tipo de erro |
Detalhe do erro |
Descrição |
badRequest (400) |
invalidChannelId |
O parâmetro channelId especificou um ID de canal inválido. |
badRequest (400) |
invalidLocation |
O valor do parâmetro location e/ou locationRadius foi formatado incorretamente. |
badRequest (400) |
invalidRelevanceLanguage |
O valor do parâmetro relevanceLanguage foi formatado incorretamente. |
badRequest (400) |
invalidSearchFilter |
A solicitação contém uma combinação inválida de filtros de pesquisa e/ou restrições. Defina o parâmetro type como video se você definir um valor para os parâmetros eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated ou videoType. |
assinaturas
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos subscriptions. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 |
Não foi possível encontrar o recurso especificado pela propriedade snippet.resourceId da solicitação. |
notFound (404) |
subscriberNotFound |
O assinante identificado com a solicitação não pode ser encontrado. |
required (400) |
publisherRequired |
O recurso de inscrição especificado na solicitação precisa usar a propriedade snippet.resourceId para identificar o canal que está sendo inscrito. |
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 aos recursos thumbnails. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 novamente mais tarde. |
videoAbuseReportReasons
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos videoAbuseReportReasons. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 aos recursos videoCategories. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos videos. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
videos.insert
| Tipo de erro |
Detalhe do erro |
Descrição |
badRequest (400) |
defaultLanguageNotSet |
A solicitação está tentando adicionar detalhes localizados do vídeo sem especificar o idioma padrão deles. |
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 programada 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 videogame inválida. |
badRequest (400) |
invalidVideoMetadata |
Os metadados da solicitação são inválidos. Esse erro ocorre se a solicitação atualiza a parte snippet de um recurso video, mas não define 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 limite diário de envio de vídeos do canal foi atingido. Essa é uma restrição da plataforma do YouTube e é totalmente separada da cota de API do seu projeto do Google Cloud. |
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 tem autorização adequada para acessar o arquivo de vídeo ou as informações de processamento. As partes fileDetails, processingDetails e suggestions estão disponíveis apenas 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á devidamente autorizada a 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 de 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 programada 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 atualiza a parte snippet de um recurso video, mas não define 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 em 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 esteja 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 alugados só podem ser avaliados por 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 avaliar desativou as classificações para esse vídeo. |
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 por abuso. |
coloca marca-d'água
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos watermarks. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.
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 devidamente autorizada ou o parâmetro channelId está definido com 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 devidamente autorizada ou o parâmetro channelId está definido com um valor inválido. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2026-11-18 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2026-11-18 UTC."],[],[]]
comentários
As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas aos recursos
comments. Esses métodos também podem retornar erros listados na seção Erros comuns de solicitação.comments.listbadRequest (400)operationNotSupportedforbidden (403)forbiddennotFound (404)commentNotFoundideparentIdda solicitação para garantir que estejam corretos.comments.setModerationStatusbadRequest (400)banWithoutRejectbanAuthorsó pode ser usado se o valor de parâmetromoderationStatusforrejected.badRequest (400)operationNotSupportedbadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidda solicitação estão corretos.comments.insertbadRequest (400)commentTextRequiredcommentque está sendo inserido precisa especificar um valor para a propriedadesnippet.textOriginal. Os comentários não podem ficar em branco.badRequest (400)commentTextTooLongcommentque está sendo inserido contém muitos caracteres na propriedadesnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedsnippet.parentId. Em um recursocommentThread, a propriedadesnippet.canReplyindica se o espectador atual pode responder à conversa.badRequest (400)parentCommentIsPrivatebadRequest (400)parentIdMissingcommentno corpo da solicitação de API não especificou um valor para a propriedadesnippet.parentId.badRequest (400)processingFailurecommentno corpo da solicitação para garantir que ele seja válido.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)parentCommentNotFoundsnippet.parentIdno corpo da solicitação para garantir que esteja correto.comments.deletebadRequest (400)processingFailureforbidden (403)forbiddennotFound (404)commentNotFoundidda solicitação para garantir que ele esteja correto.comments.updatebadRequest (400)commentTextTooLongcommentque está sendo atualizado contém muitos caracteres na propriedadesnippet.textOriginal.badRequest (400)invalidCommentMetadatabadRequest (400)operationNotSupportedbadRequest (400)processingFailurecommentno corpo da solicitação para garantir que ele seja válido.forbidden (403)forbiddenforbidden (403)ineligibleAccountnotFound (404)commentNotFoundidno corpo da solicitação para garantir que esteja correto.