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

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 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. Se o usuário autenticado estiver 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. Se o usuário autenticado estiver 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 é 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`, autentique-se 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 aceito.
`unauthorized (401)`	`authorizationRequired`	A solicitação usa o parâmetro `mine`, mas não está autorizada corretamente.
`unauthorized (401)`	`youtubeSignupRequired`	Este erro indica que o usuário possui uma conta do Google desvinculada, o que significa que o usuário tem uma Conta do Google, mas não tem um canal no YouTube. Esses usuários podem acessar muitos recursos que dependem da autorização do usuário, como classificar vídeos ou adicionar vídeos a uma playlist `watch_later`. No entanto, como exemplo, o usuário precisaria de um canal no YouTube para poder fazer upload de um vídeo. Um usuário com 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 a 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á autorizada corretamente.

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 pedida 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 de `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 faixa de legenda que não existem ou IDs de faixa associados a outros vídeos. Verifique os valores dos parâmetros `id` e `videoId` da solicitação para garantir que 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 a 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.
`badRequest (400)`	`mediaBodyRequired`	A solicitação não inclui o conteúdo da imagem.

channelSections

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a recursos channelSections. Esses métodos também podem retornar erros listados na seção Erros 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 de acordo com 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 de acordo com 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 de acordo com 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 não são esperados canais 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, portanto, não podem ser incluídas na seção do canal.
`invalidValue (400)`	`playlistsDuplicated`	A solicitação falhou porque especificou playlists duplicadas.
`invalidValue (400)`	`playlistsNeeded`	Se a propriedade `snippet.type` tiver um valor de `singlePlaylist` ou `multiplePlaylists`, a propriedade `contentDetails.playlists[]` precisará ser especificada.
`invalidValue (400)`	`playlistsNotExpected`	O recurso fornecido com a solicitação especificou um valor para a propriedade `contentDetails.playlists[]`, mas 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 o valor `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 dos 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` não passou na validação. Use o método channelSections.list para recuperar valores válidos e atualizá-los de acordo com 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 de acordo com 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 de acordo com 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 de acordo com 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 não são esperados canais 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 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 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, portanto, não podem ser incluídas na seção do canal.
`invalidValue (400)`	`playlistsDuplicated`	A solicitação falhou porque especificou playlists duplicadas.
`invalidValue (400)`	`playlistsNeeded`	Se a propriedade `snippet.type` tiver um valor de `singlePlaylist` ou `multiplePlaylists`, a propriedade `contentDetails.playlists[]` precisará ser especificada.
`invalidValue (400)`	`playlistsNotExpected`	O recurso fornecido com a solicitação especificou um valor para a propriedade `contentDetails.playlists[]`, mas não é esperado que seções de canais desse tipo tenham playlists.
`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 o valor `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 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 da autenticação do proprietário do conteúdo usando o parâmetro `onBehalfOfContentOwner`, apenas `id` ou `managedByMe` podem ser especificados.
`forbidden (403)`	`channelForbidden`	O canal especificado pelo parâmetro `id` não é compatível com a solicitação ou 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 retorna 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 "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á autorizada corretamente.
`forbidden (403)`	`promotedVideoNotAllowed`	O canal que a solicitação da API está tentando atualizar não pode ser encontrado. Verifique o valor da propriedade `id` no recurso `channel` que a solicitação enviou para garantir que o ID do canal esteja correto.
`forbidden (403)`	`websiteLinkNotAllowed`	O URL do site especificado não é permitido.
`notFound (404)`	`channelNotFound`	O canal especificado pelo parâmetro `id` não foi encontrado ou não tem opções de branding.
`notFound (404)`	`channelNotFound`	Não foi possível encontrar o canal especificado no parâmetro `id`.
`notFound (404)`	`unknownChannelId`	O ID do canal especificado não foi encontrado.
`notFound (404)`	`unknownChannelId`	O ID do canal 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.

commentThreads

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

`commentThreads.list`

Tipo de erro	Detalhe do erro	Descrição
`badRequest (400)`	`operationNotSupported`	A solicitação à API é inválida ou foi formada incorretamente. Consequentemente, o servidor de API não conseguiu entender a solicitação.
`badRequest (400)`	`processingFailure`	O servidor de API não conseguiu processar a solicitação. Embora 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 seja válido.
`forbidden (403)`	`commentsDisabled`	O vídeo identificado pelo parâmetro `videoId` está com os comentários desativados.
`forbidden (403)`	`forbidden`	Não foi possível recuperar uma ou mais conversas solicitadas devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
`notFound (404)`	`channelNotFound`	Não foi possível encontrar o canal identificado pelo parâmetro `allThreadsRelatedToChannelId`.
`notFound (404)`	`commentThreadNotFound`	Não foi possível encontrar uma ou mais sequências de comentários especificadas. Verifique os valores do parâmetro `id` 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`.

`commentThreads.insert`

Tipo de erro	Detalhe do erro	Descrição
`badRequest (400)`	`channelOrVideoIdMissing`	Cada conversa precisa estar vinculada a um canal ou vídeo. Verifique se o recurso especifica valores para as propriedades `snippet.channelId` e `snippet.videoId`. Um comentário em um vídeo aparece na página de exibição do vídeo.
`badRequest (400)`	`commentTextRequired`	O recurso `comment` que está sendo inserido precisa especificar um valor para a propriedade `snippet.topLevelComment.snippet.textOriginal`. Os comentários não podem ficar em branco.
`badRequest (400)`	`commentTextTooLong`	O recurso `comment` que está sendo inserido contém muitos caracteres na propriedade `snippet.topLevelComment.snippet.textOriginal`.
`badRequest (400)`	`invalidCommentThreadMetadata`	Os metadados da solicitação são inválidos.
`badRequest (400)`	`processingFailure`	O servidor de API não conseguiu processar a solicitação. Embora 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 seja válido.
`forbidden (403)`	`forbidden`	A conversa não foi criada porque você não tem as permissões necessárias. A solicitação pode não es devidamente autorizada.
`forbidden (403)`	`ineligibleAccount`	A conta do YouTube usada para autorizar a solicitação de API precisa ser mesclada com a Conta do Google do usuário para inserir um comentário ou uma conversa.
`notFound (404)`	`channelNotFound`	Não foi possível encontrar o canal especificado. Verifique o valor da propriedade `snippet.channelId` para garantir que esteja correto.
`notFound (404)`	`videoNotFound`	Não foi possível encontrar o vídeo especificado. Verifique o valor da propriedade `snippet.videoId` para garantir que esteja correto.

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.list`

Tipo de erro	Detalhe do erro	Descrição
`badRequest (400)`	`operationNotSupported`	A solicitação à API é inválida ou foi formada incorretamente. Por isso, o servidor de API não conseguiu entender a solicitação.
`forbidden (403)`	`forbidden`	Não foi possível recuperar um ou mais comentários solicitados devido a permissões insuficientes. A solicitação pode não es devidamente autorizada.
`notFound (404)`	`commentNotFound`	Não foi possível encontrar um ou mais dos comentários especificados. Verifique os valores dos parâmetros `id` e `parentId` da solicitação para garantir que estejam corretos.

`comments.setModerationStatus`

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

`comments.insert`

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

`comments.delete`

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

`comments.update`

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

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 expirou.
`badRequest (400)`	`invalidHasAccessToLevel`	O valor do parâmetro `hasAccessToLevel` é inválido. Não há um 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 a 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 a solicitação não tem as assinaturas ativadas.

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 já está em outra playlist em série.
`invalidValue (400)`	`playlistOperationUnsupported`	A API não oferece suporte à inserção de vídeos na playlist especificada. Por exemplo, não é possível inserir um vídeo na playlist de vídeos enviados.
`notFound (404)`	`playlistNotFound`	Não foi possível encontrar a playlist identificada com o parâmetro `playlistId` da solicitação.
`notFound (404)`	`videoNotFound`	O vídeo que você está tentando adicionar à playlist não pode ser encontrado. Verifique 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`	Não foi possível encontrar a playlist identificada com o parâmetro `playlistId` da solicitação.
`notFound (404)`	`videoNotFound`	Não foi possível encontrar o vídeo identificado com o parâmetro `videoId` da solicitação.
`required (400)`	`playlistIdRequired`	A solicitação de inscrição não especifica um valor para a propriedade obrigatória `playlistId`.
`invalidValue (400)`	`playlistOperationUnsupported`	A API não é compatível com a capacidade 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 tem autorização 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 ela não usa a classificação manual. Por exemplo, os itens da playlist podem ser classificados por data ou popularidade. Para corrigir 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 oferece suporte à atualização de vídeos na playlist especificada. Por exemplo, não é possível atualizar um vídeo na playlist "Vídeos enviados".
`notFound (404)`	`playlistItemNotFound`	Não foi possível encontrar o item da playlist identificado com a propriedade `id` da solicitação.
`notFound (404)`	`playlistNotFound`	Não foi possível encontrar a playlist identificada com o parâmetro `playlistId` da solicitação.
`required (400)`	`channelIdRequired`	A solicitação não especifica um valor para a propriedade 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 da 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`	Esta 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 oferece suporte à 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 ela não está autorizada corretamente.
`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 é compatível com a capacidade 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 `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`	Esta 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`	Esta 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 é compatível com a atualização da playlist especificada. Por exemplo, não é possível atualizar as propriedades da playlist de vídeos enviados.
`notFound (404)`	`playlistNotFound`	Não foi possível encontrar a playlist identificada com o parâmetro `id` da solicitação.
`required (400)`	`playlistTitleRequired`	A solicitação deve especificar um título da playlist.

pesquisar

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a chamadas relacionadas a 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 se o valor do parâmetro `id` da solicitação 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 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 assinatura 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 foi encerrada.
`forbidden (403)`	`accountSuspended`	Não foi possível recuperar as assinaturas porque a conta do assinante está suspensa.
`forbidden (403)`	`subscriptionForbidden`	O requerente não tem permissão para acessar as assinaturas solicitadas.
`notFound (404)`	`subscriberNotFound`	O assinante identificado com a solicitação não pode ser encontrado.

miniaturas

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

`thumbnails.set`

Tipo de erro	Detalhe do erro	Descrição
`badRequest (400)`	`invalidImage`	O conteúdo da imagem fornecida é inválido.
`badRequest (400)`	`mediaBodyRequired`	A solicitação não inclui o conteúdo da imagem.
`forbidden (403)`	`forbidden`	A miniatura não pode ser configurada para o vídeo especificado. A solicitação pode não es devidamente autorizada.
`forbidden (403)`	`forbidden`	O usuário autenticado não tem permissões para carregar e configurar miniaturas de vídeo personalizadas.
`notFound (404)`	`videoNotFound`	O vídeo no qual você está tentando inserir uma imagem em miniatura não pode ser encontrado. Verifique o valor do parâmetro `videoId` da solicitação para garantir que ele esteja correto.
`tooManyRequests (429)`	`uploadRateLimitExceeded`	O canal enviou muitas miniaturas recentemente. Tente fazer a solicitação 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 a 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 extrair 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 a 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.
`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 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 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 na nuvem 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 está devidamente autorizada 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 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)`	`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 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 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 fazer a avaliação.
`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 conteúdo.
`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.

YouTube Data API - Errors Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Erros gerais

Core API errors

Common request errors

Request context errors

atividades

activities.list

legendas

captions.delete

captions.download

captions.insert

captions.list

captions.update

channelBanners

channelBanners.insert

channelSections

channelSections.delete

channelSections.insert

channelSections.list

channelSections.update

canais

channels.list

channels.update

commentThreads

commentThreads.list

commentThreads.insert

comentários

comments.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update