YouTube Live Streaming API - Errors

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

fanFundingEvents

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos fanFundingEvents.

fanFundingEvents.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) insufficientPermissions Você não tem as permissões necessárias para acessar os eventos do Financiamento por fãs do canal.
invalidValue (400) fanFundingNotEnabledForChannelId O canal não tem o Financiamento por fãs ativado.

liveBroadcasts

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos liveBroadcasts.

liveBroadcasts.bind

Tipo de erro Detalhe do erro Descrição
backendError internalError Ocorreu um erro interno durante a vinculação.
forbidden (403) liveBroadcastBindingNotAllowed O status atual da transmissão ao vivo não permite que ela seja vinculada a um stream.
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a recuperar a transmissão ao vivo especificada. Para mais informações, consulte Como implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound A transmissão especificada pelo parâmetro id não existe.
notFound (404) liveStreamNotFound O stream especificado pelo parâmetro streamId não existe.
rateLimitExceeded userRequestsExceedRateLimit O usuário enviou solicitações demais em um determinado período.
required (400) idRequired O parâmetro id obrigatório precisa identificar a transmissão a ser vinculada.

liveBroadcasts.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) liveBroadcastDeletionNotAllowed O status atual da transmissão ao vivo não permite que ela seja excluída.
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a excluir a transmissão ao vivo especificada. Para mais informações, consulte Como implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound A propriedade id especificada no recurso liveBroadcast não identificou uma transmissão.

liveBroadcasts.insert

Tipo de erro Detalhe do erro Descrição
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a criar a transmissão ao vivo.
insufficientPermissions livePermissionBlocked O usuário que autorizou a solicitação não pode transmitir vídeo ao vivo no YouTube no momento. Detalhes que explicam por que o usuário não consegue transmitir vídeos ao vivo podem estar disponíveis nas configurações do canal do usuário em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.
invalidValue (400) invalidAutoStart O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.enableAutoStart. Nem todas as transmissões são compatíveis com essa configuração.
invalidValue (400) invalidAutoStop O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.enableAutoStop. Não é possível modificar a configuração enableAutoStop para uma transmissão persistente.
invalidValue (400) invalidDescription O recurso liveBroadcast não especificou um valor válido para a propriedade snippet.description. O valor da propriedade pode conter até 5.000 caracteres.
invalidValue (400) invalidEmbedSetting O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.enable_embed. Não é possível incorporar esta transmissão.
invalidValue (400) invalidLatencyPreferenceOptions O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.latencyPreference. Nem todas as configurações são compatíveis com essa preferência de latência.
invalidValue (400) invalidPrivacyStatus O recurso liveBroadcast continha um valor inválido para a propriedade status.privacy_status.
invalidValue (400) invalidProjection O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.projection. A projeção de uma transmissão padrão não pode ser definida como 360.
invalidValue (400) invalidScheduledEndTime O recurso liveBroadcast continha um valor inválido para a propriedade snippet.scheduledEndTime. O horário de término programado precisa seguir o horário de início programado.
invalidValue (400) invalidScheduledStartTime O recurso liveBroadcast continha um valor inválido para a propriedade snippet.scheduledStartTime. O horário de início programado precisa estar no futuro e próximo o suficiente da data atual para que a transmissão possa ser agendada de maneira confiável.
invalidValue (400) invalidTitle O recurso liveBroadcast não especificou um valor válido para a propriedade snippet.title. O valor da propriedade precisa ter entre 1 e 100 caracteres.
limitExceeded userBroadcastsExceedLimit O usuário criou muitas transmissões ao vivo ou programadas e precisa parar ou excluir algumas.
rateLimitExceeded userRequestsExceedRateLimit O usuário enviou solicitações demais em um determinado período.
required (400) privacyStatusRequired O recurso liveBroadcast precisa especificar um status de privacidade. Confira os valores válidos do privacyStatus.
required (400) scheduledEndTimeRequired O recurso liveBroadcast precisa especificar a propriedade snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired O recurso liveBroadcast precisa especificar a propriedade snippet.scheduledStartTime.
required (400) titleRequired O recurso liveBroadcast precisa especificar a propriedade snippet.title.

liveBroadcasts.list

Tipo de erro Detalhe do erro Descrição
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a recuperar a transmissão ao vivo.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.

liveBroadcasts.transition

Tipo de erro Detalhe do erro Descrição
backendError errorExecutingTransition Ocorreu um erro ao alterar o status da transmissão.
forbidden (403) errorStreamInactive A transição solicitada não é permitida quando o stream vinculado à transmissão está inativo.
forbidden (403) invalidTransition A transmissão ao vivo não pode passar do status atual para o solicitado.
forbidden (403) redundantTransition A transmissão ao vivo já está no status solicitado ou está sendo processada para o status solicitado.
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a fazer a transição da transmissão ao vivo.
insufficientPermissions livePermissionBlocked O usuário que autorizou a solicitação não pode transmitir vídeo ao vivo no YouTube no momento. Detalhes que explicam por que o usuário não consegue transmitir vídeos ao vivo podem estar disponíveis nas configurações do canal do usuário em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound A transmissão especificada pelo parâmetro id não existe.
rateLimitExceeded (403) userRequestsExceedRateLimit O usuário enviou solicitações demais em um determinado período.
required (400) idRequired O parâmetro id obrigatório precisa identificar a transmissão com o status que você quer mudar.
required (400) statusRequired A solicitação de API precisa especificar um valor para o parâmetro status.

liveBroadcasts.update

Tipo de erro Detalhe do erro Descrição
forbidden (403) closedCaptionsTypeModificationNotAllowed O valor contentDetails.closedCaptionsType só pode ser modificado quando a transmissão está no status created ou ready.
forbidden (403) enableAutoStartModificationNotAllowed O valor contentDetails.enableAutoStart só pode ser modificado quando o stream está inativo e a transmissão está no status created ou ready.
forbidden (403) enableClosedCaptionsModificationNotAllowed O valor contentDetails.enableClosedCaptions só pode ser modificado quando o status da transmissão é created ou ready.
forbidden (403) enableDvrModificationNotAllowed O valor contentDetails.enableDvr só pode ser modificado quando o status da transmissão é created ou ready.
forbidden (403) enableMonitorStreamModificationNotAllowed O valor contentDetails.monitorStream.enableMonitorStream só pode ser modificado quando o status da transmissão é created ou ready.
forbidden (403) recordFromStartModificationNotAllowed O valor contentDetails.recordFromStart só pode ser modificado quando o status da transmissão é created ou ready.
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a atualizar a transmissão ao vivo especificada. Para mais informações, consulte Como implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.
invalidValue (400) invalidAutoStart O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.enableAutoStart. Não é possível modificar a configuração enableAutoStart para uma transmissão persistente.
invalidValue (400) invalidAutoStop O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.enableAutoStop. Não é possível modificar a configuração enableAutoStop para uma transmissão persistente.
invalidValue (400) invalidDescription O recurso liveBroadcast não especificou um valor válido para a propriedade snippet.description. snippet.description pode ter até 5.000 caracteres.
invalidValue (400) invalidEmbedSetting O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.enable_embed. Não é possível incorporar esta transmissão.
invalidValue (400) invalidEnableClosedCaptions No recurso liveBroadcast, o valor da propriedade contentDetails.enableClosedCaptions é incompatível com o valor da configuração contentDetails.closedCaptionType. Modifique o recurso para incluir apenas uma das duas propriedades e reenvie a solicitação.
invalidValue (400) invalidLatencyPreferenceOptions O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.latencyPreference. Nem todas as configurações são compatíveis com essa preferência de latência.
invalidValue (400) invalidPrivacyStatus O recurso liveBroadcast não especificou um status de privacidade válido. Confira os valores válidos do privacyStatus.
invalidValue (400) invalidProjection O recurso liveBroadcast continha um valor inválido para a propriedade contentDetails.projection. A projeção de uma transmissão persistente não pode ser definida como 360.
invalidValue (400) invalidScheduledEndTime O recurso liveBroadcast continha um valor inválido para a propriedade snippet.scheduledEndTime. O horário de término programado precisa seguir o horário de início programado.
invalidValue (400) invalidScheduledStartTime O recurso liveBroadcast continha um valor inválido para a propriedade snippet.scheduledStartTime. O horário de início programado precisa ser no futuro.
invalidValue (400) invalidTitle O recurso liveBroadcast não especificou um valor válido para a propriedade snippet.title. snippet.title precisa ter entre 1 e 100 caracteres.
notFound (404) liveBroadcastNotFound A propriedade id especificada no recurso liveBroadcast não identificou uma transmissão.
required (400) broadcastStreamDelayMsRequired O recurso liveBroadcast não especificou a propriedade contentDetails.monitorStream.broadcastStreamDelayMs.
required (400) enableMonitorStreamRequired O recurso liveBroadcast não especificou a propriedade contentDetails.monitorStream.enableMonitorStream.
required (400) idRequired O recurso liveBroadcast precisa incluir e especificar um valor para a propriedade id.
required (400) privacyStatusRequired O recurso liveBroadcast não especificou um status de privacidade. Consulte os valores válidos de privacyStatus.
required (400) scheduledEndTimeRequired O recurso liveBroadcast não especificou a propriedade snippet.scheduledEndTime.
required (400) scheduledStartTimeRequired O recurso liveBroadcast não especificou a propriedade snippet.scheduledStartTime.
required (400) titleRequired O recurso liveBroadcast não especificou a propriedade snippet.title.

liveBroadcasts.cuepoint

Tipo de erro Detalhe do erro Descrição
insufficientPermissions (403) insufficientLivePermissions A solicitação não está autorizada a inserir um marcador na transmissão ao vivo.
insufficientPermissions (403) liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para fazer streaming de vídeo ao vivo no YouTube. Saiba mais em https://support.google.com/youtube/answer/2474026 e https://www.youtube.com/features.
rateLimitExceeded (403) userRequestsExceedRateLimit O usuário enviou solicitações demais em um determinado período.
required (400) idRequired O parâmetro id obrigatório precisa identificar a transmissão em que você quer inserir um marcador.
required (400) cueTypeRequired O campo cueType obrigatório precisa ser especificado no corpo da solicitação da API.
notFound (404) liveBroadcastNotFound A transmissão especificada pelo parâmetro id não existe.
invalidValue (400) conflictingTimeFields Só é possível especificar insertionOffsetTimeMs e walltimeMs. Definir os dois valores causa um erro. Se você não definir nenhum valor, o YouTube usará o tempo padrão de insertionOffsetTimeMs (0), o que significa que o marcador será inserido o mais rápido possível.
invalidValue (400) invalidInsertionOffsetTimeMs O recurso cuepoint especificou um valor inválido para a propriedade insertionOffsetTimeMs. O valor precisa ser 0 ou um número inteiro positivo.
invalidValue (400) invalidWalltimeMs O recurso cuepoint especificou um valor inválido para a propriedade walltimeMs. O valor precisa ser um número inteiro que represente um carimbo de data/hora da época.
backendError (5xx) serviceUnavailable O serviço não está disponível. Tente de novo após alguns minutos.

liveChatBans

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos liveChatBans.

liveChatBans.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden A proibição especificada não pode ser removida. Esse erro pode ocorrer se a solicitação for autorizada por um moderador que estiver tentando remover a proibição de outro moderador.
forbidden (403) insufficientPermissions Você não tem as permissões necessárias para remover a proibição especificada.
invalidValue (400) invalidLiveChatBanId O parâmetro id especifica um valor inválido.
notFound (404) liveChatBanNotFound A proibição especificada não pode ser encontrada.

liveChatBans.insert

Tipo de erro Detalhe do erro Descrição
forbidden (403) insufficientPermissions Você não tem as permissões necessárias para banir um usuário do chat ao vivo especificado.
forbidden (403) liveChatBanInsertionNotAllowed Não é possível criar a proibição especificada. Esse erro poderá ocorrer se a solicitação tentar banir o proprietário do chat ou outro moderador.
invalidValue (400) invalidChannelId Não foi possível encontrar o ID do canal especificado.
invalidValue (400) invalidLiveChatId O valor snippet.liveChatId especificado na solicitação é inválido. Verifique o recurso liveBroadcast associado para garantir que você tenha o valor correto.
notFound (404) liveChatNotFound Não foi possível encontrar o chat ao vivo especificado. Verifique o recurso liveBroadcast associado para garantir que você está definindo a propriedade snippet.liveChatId com o valor correto.
notFound (404) liveChatUserNotFound O usuário do chat ao vivo que você está tentando banir não foi encontrado.
required (400) bannedUserChannelIdRequired O recurso liveChatBan enviado no corpo da solicitação precisa especificar um valor para a propriedade snippet.bannedUserDetails.channelId.
required (400) liveChatIdRequired O recurso liveChatBan enviado no corpo da solicitação precisa especificar um valor para a propriedade snippet.liveChatId.

liveChatMessages

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos liveChatMessages.

liveChatMessages.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Você não tem as permissões necessárias para excluir a mensagem especificada.
forbidden (403) modificationNotAllowed O recurso liveChatMessage especificado não pode ser excluído. O parâmetro id pode identificar uma mensagem criada por um moderador ou outro usuário com mensagens que não podem ser excluídas.
notFound (404) liveChatMessageNotFound A mensagem que você está tentando excluir não pode ser encontrada. Verifique o valor do parâmetro id para garantir que ele está correto.

liveChatMessages.insert

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Você não tem as permissões necessárias para criar a mensagem especificada.
forbidden (403) liveChatDisabled O chat ao vivo especificado foi desativado pelo proprietário. Por isso, não é possível adicionar mensagens a ele.
forbidden (403) liveChatEnded O chat ao vivo especificado não está mais ativo.
invalidValue (400) messageTextInvalid O texto da mensagem (snippet.textMessageDetails.messageText) não é válido.
notFound (404) liveChatNotFound O chat ao vivo identificado na solicitação da API não existe. Esse erro ocorrerá se o bate-papo tiver sido excluído pelo proprietário.
rateLimitExceeded rateLimitExceeded O usuário postou muitas mensagens de chat em um determinado período.
required (400) liveChatIdRequired O recurso liveChatMessage precisa incluir e especificar um valor para a propriedade snippet.liveChatId.
required (400) messageTextRequired O recurso liveChatMessage precisa incluir e especificar um valor para a propriedade snippet.textMessageDetails.messageText.
required (400) typeRequired O recurso liveChatMessage precisa incluir e especificar um valor para a propriedade snippet.type. Defina o valor do parâmetro como text.

liveChatMessages.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Você não tem as permissões necessárias para recuperar as mensagens do chat ao vivo especificado.
forbidden (403) liveChatDisabled O chat ao vivo não está ativado para a transmissão especificada.
forbidden (403) liveChatEnded O chat ao vivo especificado não está mais ativo.
notFound (404) liveChatNotFound O chat ao vivo que você está tentando recuperar não foi encontrado. Verifique o valor do parâmetro liveChatId da solicitação para garantir que ele está correto.
rateLimitExceeded rateLimitExceeded A solicitação foi enviada muito rapidamente depois da solicitação anterior. Esse erro ocorre quando as solicitações da API para recuperar mensagens estão sendo enviadas com mais frequência do que as taxas de atualização do YouTube, o que desperdiça largura de banda desnecessariamente.

liveCuepoints

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos liveCuepoints.

liveCuepoints.insert

Tipo de erro Detalhe do erro Descrição
invalidValue (400) conflictingTimeFields Só é possível especificar offsetTimeMs ou walltime.

liveStreams

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos liveStreams.

liveStreams.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) liveStreamDeletionNotAllowed A transmissão ao vivo especificada não pode ser excluída porque está vinculada a uma transmissão que ainda não foi concluída.
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a excluir a transmissão ao vivo especificada. Para mais informações, consulte Como implementar a autenticação OAuth 2.0.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Para mais informações, consulte Qualificação para recursos.
notFound (404) liveStreamNotFound A transmissão ao vivo especificada não existe.

liveStreams.insert

Tipo de erro Detalhe do erro Descrição
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a criar a transmissão ao vivo especificada.
insufficientPermissions livePermissionBlocked O usuário que autorizou a solicitação não pode transmitir vídeo ao vivo no YouTube no momento. Detalhes que explicam por que o usuário não consegue transmitir vídeos ao vivo podem estar disponíveis nas configurações do canal do usuário em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.
invalidValue (400) invalidDescription O valor da propriedade snippet.description no recurso liveStream pode ter até 10.000 caracteres.
invalidValue (400) invalidFormat O valor da propriedade cdn.format no recurso liveStream é inválido.
invalidValue (400) invalidFrameRate O valor da propriedade cdn.frameRate no recurso liveStream é inválido.
invalidValue (400) invalidIngestionType O valor da propriedade cdn.ingestionType no recurso liveStream é inválido.
invalidValue (400) invalidResolution O valor da propriedade cdn.resolution no recurso liveStream é inválido.
invalidValue (400) invalidTitle O valor da propriedade snippet.title no recurso liveStream precisa ter entre 1 e 128 caracteres.
rateLimitExceeded userRequestsExceedRateLimit O usuário enviou solicitações demais em um determinado período.
required (400) cdnRequired O recurso liveStream precisa conter o objeto cdn.
required (400) frameRateRequired A API vai retornar esse erro se você especificar um valor para a propriedade cdn.resolution, mas não para a cdn.frameRate.
required (400) ingestionTypeRequired O recurso liveStream precisa especificar um valor para a propriedade cdn.ingestionType.
required (400) resolutionRequired A API vai retornar esse erro se você especificar um valor para a propriedade cdn.frameRate, mas não para a cdn.resolution.
required (400) titleRequired O recurso liveStream precisa especificar um valor para a propriedade snippet.title.

liveStreams.list

Tipo de erro Detalhe do erro Descrição
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a recuperar a transmissão ao vivo especificada.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.

liveStreams.update

Tipo de erro Detalhe do erro Descrição
forbidden (403) liveStreamModificationNotAllowed Não é possível modificar a transmissão ao vivo especificada no estado atual. Para mais informações, consulte O ciclo de uma transmissão.
forbidden (403) liveStreamModificationNotAllowed A API não permite que você mude o valor dos campos cdn.format, cdn.frameRate, cdn.ingestionType ou cdn.resolution após a criação do stream.
forbidden (403) liveStreamModificationNotAllowed A API não permite que você altere um stream reutilizável para não reutilizável ou vice-versa. Para mais informações, consulte Noções básicas sobre transmissões e streams.
insufficientPermissions insufficientLivePermissions A solicitação não está autorizada a atualizar a transmissão ao vivo especificada. Para mais informações, consulte Como implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para transmitir vídeo ao vivo no YouTube. Saiba mais em https://www.youtube.com/features.
invalidValue (400) invalidDescription O valor da propriedade snippet.description no recurso de transmissão ao vivo pode ter até 10.000 caracteres.
invalidValue (400) invalidTitle O valor da propriedade snippet.title no recurso de transmissão ao vivo precisa ter entre 1 e 128 caracteres.
notFound (404) liveStreamNotFound A transmissão ao vivo especificada não existe.
required (400) idRequired O recurso liveStream precisa especificar um valor para a propriedade id.
required (400) ingestionTypeRequired O recurso liveStream precisa especificar um valor para a propriedade cdn.ingestionType.
required (400) titleRequired O recurso liveStream precisa especificar um valor para a propriedade snippet.title.

patrocinadores

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos sponsors.

sponsors.list

Tipo de erro Detalhe do erro Descrição
forbidden (403) insufficientPermissions Você não tem as permissões necessárias para acessar os patrocinadores do canal.
invalidValue (400) invalidValueInRequest A solicitação contém um valor inválido.
invalidValue (400) sponsorshipNotEnabledForChannelId O canal não tem patrocínios ativados.