Este documento identifica os diferentes tipos de erro 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 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 este último. |
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 este último. |
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 OAuth 2.0 fornecido para a solicitação especifica escopos insuficientes para acessar os dados solicitados. |
notFound (404) |
contentOwnerAccountNotFound |
A conta especificada do proprietário do conteúdo 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 da solicitação do parâmetro mine não é compatível. |
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 atue 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 compatível. |
badRequest (400) |
unsupportedRegionCode |
O parâmetro regionCode especifica um código de região não compatível. |
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 diversos recursos que dependem da autorização do usuário, como classificação ou adição de 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 tem certeza de que tem uma Conta do Google, mas talvez ainda não tenha vinculado essa conta a um canal do YouTube.Esse erro costuma ocorrer quando você tenta usar o fluxo da conta de serviço do OAuth 2.0. O YouTube não oferece suporte a contas de serviço, e se você tentar autenticar usando uma conta de serviço, vai receber esse erro. A postagem do blog da API YouTube, introduzindo 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
activities.insert
não
é mais compatível.
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do activities
. Esses métodos também podem retornar erros listados na seção Erros comuns.
activities.list
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
forbidden (403) |
homeParameterDeprecated |
Os dados de atividade da página inicial do usuário não estão disponíveis por meio dessa API. Esse erro poderá 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 foi devidamente autorizada. |
notFound (404) |
channelNotFound |
O ID do canal identificado pelo parâmetro channelId da solicitação não foi encontrado. |
notFound (404) |
homeChannelNotFound |
O feed da página inicial do YouTube não pode ser encontrado para o usuário autenticado no momento. |
unauthorized (401) |
authorizationRequired |
A solicitação usa o parâmetro home , mas não está devidamente autorizada. |
captions
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do captions
. Esses métodos também podem retornar erros listados na seção Erros 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 está 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 ser devidamente autorizada ou talvez a ordem do vídeo não tenha ativado contribuições de terceiros para essa legenda. |
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 está 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 snippet.language e snippet.name especificados. Um vídeo pode ter várias faixas para o mesmo idioma, mas cada uma delas precisa ter um nome diferente.Existem várias maneiras de resolver o erro. Você pode excluir a faixa existente e inserir uma nova faixa 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 enviar a 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 . |
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 vai ocorrer 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 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 carregou um arquivo de legenda atualizado. O conteúdo real da faixa será necessá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 está correto. |
channelBanners
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do channelBanners
. Esses métodos também podem retornar erros listados na seção Erros comuns.
channelBanners.insert
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
bannerAlbumFull |
Seu álbum de arte do canal do YouTube tem muitas imagens. Acesse http://photos.google.com, navegue até a página dos álbuns e remova algumas das imagens desse álbum. |
badRequest (400) |
mediaBodyRequired |
A solicitação não inclui o conteúdo da imagem. |
channelSections
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do channelSections
. Esses métodos também podem retornar erros listados na seção Erros 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 do 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 |
A seção do canal que você está tentando atualizar não foi encontrada. |
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 |
Falha na validação de uma das chaves de idioma do objeto localizations . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos 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 |
Falha na validação de um dos valores na lista targeting.countries . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Falha na validação de um dos valores na lista targeting.languages . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Falha na validação de um dos valores na lista targeting.regions . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos 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 está devidamente autenticada ou não tem suporte para 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 o valor da propriedade snippet.type for multipleChannels , será necessário especificar a propriedade contentDetails.channels[] com 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 são esperados canais para esse tipo de seção de canais. |
invalidValue (400) |
contentDetailsNeeded |
O recurso inserido precisa conter um objeto contentDetails para esse tipo de seção de canais. |
invalidValue (400) |
inValidPosition |
A propriedade snippet.position contém um valor inválido. |
invalidValue (400) |
maxChannelSectionExceeded |
Não foi 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 o valor da propriedade snippet.type for singlePlaylist , contentDetails.playlists[] precisará especificar exatamente uma playlist. |
invalidValue (400) |
ownChannelInChannels |
Você não pode incluir seu próprio canal em uma seção do canal que aparece no canal em questão. |
invalidValue (400) |
playlistIsPrivate |
Uma ou mais das playlists especificadas são privadas 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 o valor da propriedade snippet.type for singlePlaylist ou multiplePlaylists , será necessário especificar a propriedade contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
O recurso fornecido com a solicitação especificou um valor para a propriedade contentDetails.playlists[] , mas playlists não são esperadas para esse tipo de seção de canal. |
invalidValue (400) |
snippetNeeded |
Você precisa 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 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 em questão. |
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 |
O canal associado à solicitação não foi encontrado. |
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 |
Falha na validação de uma das chaves de idioma do objeto localizations . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos 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 |
Falha na validação de um dos valores na lista targeting.countries . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Falha na validação de um dos valores na lista targeting.languages . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Falha na validação de um dos valores na lista targeting.regions . Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com as diretrizes na documentação de recursos 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 está devidamente autenticada ou não tem suporte para 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 o valor da propriedade snippet.type for multipleChannels , será necessário especificar a propriedade contentDetails.channels[] com 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 são esperados canais para esse tipo de seção de canais. |
invalidValue (400) |
contentDetailsNeeded |
O recurso que você está atualizando precisa conter um objeto contentDetails para esse tipo de seção de canais. |
invalidValue (400) |
idInvalid |
A propriedade id especifica um ID de seção do 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 o valor da propriedade snippet.type for singlePlaylist , contentDetails.playlists[] precisará especificar exatamente uma playlist. |
invalidValue (400) |
ownChannelInChannels |
Você não pode incluir seu próprio canal em uma seção do canal que aparece no canal em questão. |
invalidValue (400) |
playlistIsPrivate |
Uma ou mais das playlists especificadas são privadas 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 o valor da propriedade snippet.type for singlePlaylist ou multiplePlaylists , será necessário especificar a propriedade contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
O recurso fornecido com a solicitação especificou um valor para a propriedade contentDetails.playlists[] , mas playlists não são esperadas para esse tipo de seção de canal. |
invalidValue (400) |
snippetNeeded |
Você precisa 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 |
A seção do canal que você está tentando atualizar não foi encontrada. |
notFound (404) |
playlistNotFound |
Não foi possível encontrar uma ou mais playlists especificadas. |
canais
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do channels
. Esses métodos também podem retornar erros listados na seção Erros comuns.
channels.list
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
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 suporta a solicitação ou a solicitação não está autorizada corretamente. |
notFound (404) |
categoryNotFound |
A categoria identificada pelo parâmetro categoryId não foi encontrada. Use o método guideCategories.list para recuperar uma lista de valores válidos. |
notFound (404) |
channelNotFound |
O canal especificado no parâmetro id não foi encontrado. |
channels.update
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
brandingValidationError |
Falha na validação de um dos valores no objeto brandingSettings . 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 de recursos 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 o 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 atualize-os de acordo com as diretrizes na documentação de recursos 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 invideo Promotion. |
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 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 ajuste de horário inválido na parte invideo Promotion. |
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. Verifique o valor da propriedade invideoPromotion.timing.type no recurso que a solicitação enviou. |
badRequest (400) |
localizationValidationError |
Falha na validação de um dos valores no objeto de localizações. Use o método channels.list para recuperar valores válidos e não se esqueça de atualizá-los seguindo as orientações descritas na documentação de recursos de canais. |
badRequest (400) |
tooManyPromotedItems |
Número de itens promovidos permitidos excedidos na parte invideo Promotion. |
forbidden (403) |
channelForbidden |
O canal especificado no parâmetro id não suporta 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 marca. |
notFound (404) |
channelNotFound |
O canal especificado no parâmetro id não foi encontrado. |
notFound (404) |
unknownChannelId |
O ID do canal especificado não foi encontrado. |
notFound (404) |
unknownChannelId |
O ID do canal specificUploadBy 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 invideo Promotion. |
required (400) |
requiredItemId |
Os metadados da solicitação devem especificar um ID de item da parte invideo Promotion. |
required (400) |
requiredTimingOffset |
Os metadados da solicitação devem especificar um ajuste de horário 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 de site na parte invideo Promotion. Defina o valor da propriedade invideoPromotion.items[].id.websiteUrl no recurso que a solicitação envia. |
Conversas de comentários
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do commentThreads
. Esses métodos também podem retornar erros listados na seção Erros comuns.
commentThreads.list
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
operationNotSupported |
O filtro de ID só é compatível com comentários baseados no Google+. |
badRequest (400) |
processingFailure |
O servidor de API falhou ao processar a solicitação. Embora isso possa ser um erro temporário, 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 é válido. |
forbidden (403) |
commentsDisabled |
O vídeo identificado pelo parâmetro videoId desativou os comentários. |
forbidden (403) |
forbidden |
Não é possível recuperar uma ou mais das conversas de comentário solicitadas devido à insuficiência de permissões. A solicitação pode não es devidamente autorizada. |
notFound (404) |
channelNotFound |
Não foi possível encontrar o canal identificado pelos parâmetros channelId ou allThreadsRelatedToChannelId . |
notFound (404) |
commentThreadNotFound |
Não foi possível encontrar uma ou mais sequências de comentários especificadas. Verifique os valores do parâmetro id 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 . |
commentThreads.insert
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
channelOrVideoIdMissing |
Cada sequência de comentários precisa estar vinculada a um canal ou 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 vazios. |
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 de API falhou ao processar a solicitação. Embora isso possa ser um erro temporário, 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 é válido. |
forbidden (403) |
forbidden |
Não foi possível criar a conversa de comentários 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 deve ser mesclada com a Conta do Google do usuário para inserir um comentário ou uma sequência de comentários. |
notFound (404) |
channelNotFound |
Não foi possível encontrar o canal especificado. Verifique se o valor da propriedade snippet.channelId está correto. |
notFound (404) |
videoNotFound |
Não foi possível encontrar o vídeo especificado. Verifique se o valor da propriedade snippet.videoId está correto. |
participantes
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do members
. Esses métodos também podem retornar erros listados na seção Erros comuns.
members.list
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
O canal do criador de conteúdo que está autorizando 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 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 ocorrerá se o valor do parâmetro filterByMemberChannelId especificar mais de 100 canais. |
assinaturasLevels
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do members
. Esses métodos também podem retornar erros listados na seção Erros comuns.
membershipsLevels.list
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
channelMembershipsNotEnabled |
O canal do criador de conteúdo que está autorizando a solicitação não tem os Clubes dos canais ativados. |
playlistItems
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do playlistItems
. Esses métodos também podem retornar erros listados na seção Erros comuns.
playlistItems.delete
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
A solicitação não está devidamente autorizada a excluir o item da playlist especificado. |
notFound (404) |
playlistItemNotFound |
O item da playlist identificado com o parâmetro id da solicitação não foi encontrado. |
invalidValue (400) |
playlistOperationUnsupported |
A API não suporta o recurso de exclusão de vídeos da lista de reprodução especificada. Por exemplo, não é possível excluir um conteúdo 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 a inserir o item da 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 é suportado para esta operação. O ID do recurso identifica o item que está sendo adicionado à playlist (por exemplo, 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, itens da playlist podem ser classificados por data ou popularidade. Para solucionar 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 para Manual nas configurações da playlist. É possível ajustar essa configuração 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 tem 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 |
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 ele está correto. |
required (400) |
channelIdRequired |
A solicitação não especifica um valor para a propriedade channelId necessária. |
required (400) |
playlistIdRequired |
A solicitação não especifica um valor para a propriedade playlistId necessá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 |
A playlist identificada com o parâmetro playlistId da solicitação não foi encontrada. |
notFound (404) |
videoNotFound |
O vídeo identificado com o parâmetro videoId da solicitação não foi encontrado. |
required (400) |
playlistIdRequired |
A solicitação de inscrição não especifica um valor para a propriedade playlistId necessária. |
invalidValue (400) |
playlistOperationUnsupported |
A API não oferece suporte ao recurso de 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 a atualizar o item da 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 é suportado para esta operação. O ID do recurso identifica o item que está sendo adicionado à playlist (por exemplo, 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, itens da playlist podem ser classificados por data ou popularidade. Para solucionar 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 para Manual nas configurações da playlist. É possível ajustar essa configuração no Gerenciador de vídeos do YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
A API não suporta a capacidade de atualizar vídeos na lista de reprodução especificada. Por exemplo, não é possível atualizar um vídeo na playlist de vídeos enviados. |
notFound (404) |
playlistItemNotFound |
O item da playlist identificado com a propriedade id da solicitação não foi encontrado. |
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 channelId necessária. |
required (400) |
playlistIdRequired |
A solicitação não especifica um valor para a propriedade playlistId necessária. |
required (400) |
playlistItemIdRequired |
O recurso do item da playlist especificado na solicitação precisa usar a propriedade id para identificar o item da playlist que está sendo atualizado. |
playlists
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do playlists
. Esses métodos também podem retornar erros listados na seção Erros comuns.
playlists.delete
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
forbidden (403) |
playlistForbidden |
Esta operação é proibida ou a solicitação não foi 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 suporta o recurso de 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 a solicitação não está autorizada corretamente. |
notFound (404) |
channelNotFound |
O canal especificado no parâmetro channelId não foi encontrado. |
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 oferece suporte ao recurso de 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 o localizations . |
badRequest (400) |
localizationValidationError |
Falha na validação de um dos valores no objeto de localizações. Use o método playlists.list para recuperar valores válidos e não se esqueça de atualizá-los de acordo com as orientações contidas na documentação de recursos de playlists. |
badRequest (400) |
maxPlaylistExceeded |
Não é possível criar a playlist, porque o canal já atingiu o número máximo permitido. |
forbidden (403) |
playlistForbidden |
Esta operação é proibida ou a solicitação não foi 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 o localizations . |
badRequest (400) |
localizationValidationError |
Falha na validação de um dos valores no objeto de localizações. Use o método playlists.list para recuperar valores válidos e não se esqueça de atualizá-los de acordo com as orientações contidas na documentação de recursos de playlists. |
forbidden (403) |
playlistForbidden |
Esta operação é proibida ou a solicitação não foi devidamente autorizada. |
invalidValue (400) |
invalidPlaylistSnippet |
A solicitação fornece um snippet de playlist inválido. |
invalidValue (400) |
playlistOperationUnsupported |
A API não suporta a capacidade de atualizar a lista de reprodução 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. |
search
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do search
. Esses métodos também podem retornar erros listados na seção Erros comuns.
search.list
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (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. É necessário definir 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 . |
subscriptions
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do subscriptions
. Esses métodos também podem retornar erros listados na seção Erros comuns.
subscriptions.delete
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
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 está 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 inscrições. |
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 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 |
As inscrições não podem ser recuperadas porque a conta do assinante está fechada. |
forbidden (403) |
accountSuspended |
As inscrições não podem ser recuperadas porque a conta do assinante está suspensa |
forbidden (403) |
subscriptionForbidden |
O solicitante não tem permissão para acessar as inscrições solicitadas. |
notFound (404) |
subscriberNotFound |
O assinante identificado com a solicitação não pode ser encontrado. |
thumbnails
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do thumbnails
. Esses métodos também podem retornar erros listados na seção Erros comuns.
thumbnails.set
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (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 está correto. |
tooManyRequests (429) |
uploadRateLimitExceeded |
O canal enviou muitas miniaturas recentemente. Tente novamente mais tarde. |
videoAbuseReportReasons
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do videoAbuseReportReasons
. Esses métodos também podem retornar erros listados na seção Erros 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 mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do videoCategories
. Esses métodos também podem retornar erros listados na seção Erros comuns.
videoCategories.list
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
notFound (404) |
videoCategoryNotFound |
A categoria de vídeo identificada pelo parâmetro id não foi encontrada. 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 às chamadas relacionadas aos recursos do videos
. Esses métodos também podem retornar erros listados na seção Erros comuns.
videos.insert
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
A solicitação está tentando adicionar detalhes do vídeo localizado sem especificar o idioma padrão dos detalhes. |
badRequest (400) |
invalidCategoryId |
A propriedade snippet.categoryId especifica um ID de categoria inválido. Use o método videoCategories.list para recuperar 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 de 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 vai ocorrer 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á devidamente autorizada a 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 |
O vídeo que você está tentando recuperar não pode ser encontrado. Verifique o valor do parâmetro id da solicitação para garantir que ele está 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 está correto. |
videos.update
Tipo de erro | Detalhe do erro | Descrição |
---|---|---|
badRequest (400) |
defaultLanguageNotSet |
A solicitação de API está tentando adicionar detalhes do vídeo localizado 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 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 vai ocorrer 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 deve verificar seu endereço de e-mail antes da classificação. |
badRequest (400) |
invalidRating |
A solicitação continha um valor inesperado para o parâmetro rating . |
badRequest (400) |
videoPurchaseRequired |
Os vídeos de locação 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 avaliar desativou as classificações dele. |
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 está 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 em que você está tentando denunciar abuso. |
coloca marca-d'água
As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do watermarks
. Esses métodos também podem retornar erros listados na seção Erros 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 ser devidamente autorizada ou o parâmetro channelId está 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 ser devidamente autorizada ou o parâmetro channelId está definido como um valor inválido. |
comments
comments.markAsSpam
não é mais compatível.As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos do
comments
. Esses métodos também podem retornar erros listados na seção Erros comuns.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
eparentId
da solicitação para garantir que eles estejam corretos.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
só pode ser usado se o valor do parâmetromoderationStatus
forrejected
.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
da solicitação para garantir que eles estejam corretos.comments.insert
badRequest (400)
commentTextRequired
comment
que está sendo inserido precisa especificar um valor para a propriedadesnippet.textOriginal
. Os comentários não podem ficar vazios.badRequest (400)
commentTextTooLong
comment
que está sendo inserido contém muitos caracteres na propriedadesnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
. Em um recursocommentThread
, a propriedadesnippet.canReply
indica se o visualizador atual pode responder à linha de execução.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
no corpo da solicitação de API não especificou um valor para a propriedadesnippet.parentId
.badRequest (400)
processingFailure
comment
no corpo da solicitação para garantir que ele é válido.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
no corpo da solicitação para garantir que ele está correto.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
da solicitação para garantir que ele está correto.comments.update
badRequest (400)
commentTextTooLong
comment
que está sendo atualizado contém muitos caracteres na propriedadesnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
no corpo da solicitação para garantir que ele é válido.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
no corpo da solicitação para garantir que ele está correto.