YouTube Live Streaming API - Errors

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

liveBroadcasts

As tabelas a seguir identificam as mensagens de erro que a API retorna em resposta a 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 Implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações em https://www.youtube.com/features.
notFound (404) liveBroadcastNotFound A transmissão especificada pelo parâmetro id não existe.
notFound (404) liveStreamNotFound O fluxo especificado pelo parâmetro streamId não existe.
rateLimitExceeded userRequestsExceedRateLimit O usuário enviou muitas solicitações 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 Implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações 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 No momento, o usuário que autorizou a solicitação não pode transmitir vídeos ao vivo no YouTube. Os detalhes que explicam por que o usuário não pode transmitir vídeos ao vivo podem estar disponíveis nas configurações do canal em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações 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 ao vivo 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 de uma transmissão permanente.
invalidValue (400) invalidDescription O recurso liveBroadcast não especificou um valor válido para a propriedade snippet.description. O valor da propriedade 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) 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 ser posterior ao 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 e próximo o suficiente da data atual para que uma transmissão possa ser programada de forma confiável para esse horário.
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 interromper ou excluir algumas delas.
rateLimitExceeded userRequestsExceedRateLimit O usuário enviou muitas solicitações em um determinado período.
required (400) privacyStatusRequired O recurso liveBroadcast precisa especificar um status de privacidade. Consulte valores privacyStatus válidos.
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 tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações em https://www.youtube.com/features.

liveBroadcasts.transition

Tipo de erro Detalhe do erro Descrição
backendError errorExecutingTransition Ocorreu um erro ao mudar 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 mudar do status atual para o solicitado.
forbidden (403) redundantTransition A transmissão ao vivo já está no status solicitado ou em processamento 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 No momento, o usuário que autorizou a solicitação não pode transmitir vídeos ao vivo no YouTube. Os detalhes que explicam por que o usuário não pode transmitir vídeos ao vivo podem estar disponíveis nas configurações do canal em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações 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 muitas solicitações em um determinado período.
required (400) idRequired O parâmetro obrigatório id precisa identificar a transmissão que você quer mudar de status.
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 de contentDetails.closedCaptionsType só pode ser modificado quando a transmissão ao vivo está no status created ou ready.
forbidden (403) enableAutoStartModificationNotAllowed O valor de 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 de contentDetails.enableClosedCaptions só pode ser modificado quando o status da transmissão ao vivo é created ou ready.
forbidden (403) enableDvrModificationNotAllowed O valor de contentDetails.enableDvr só pode ser modificado quando o status da transmissão ao vivo é created ou ready.
forbidden (403) enableMonitorStreamModificationNotAllowed O valor de contentDetails.monitorStream.enableMonitorStream só pode ser modificado quando o status da transmissão ao vivo é created ou ready.
forbidden (403) recordFromStartModificationNotAllowed O valor de contentDetails.recordFromStart só pode ser modificado quando o status da transmissão ao vivo é 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 Implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações 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 de uma transmissão permanente.
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 de uma transmissão permanente.
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. Consulte valores privacyStatus válidos.
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 ser posterior ao 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. O 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 para conferir 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 ponto de sinalização na transmissão ao vivo.
insufficientPermissions (403) liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações em https://support.google.com/youtube/answer/2474026 e https://www.youtube.com/features.
rateLimitExceeded (403) userRequestsExceedRateLimit O usuário enviou muitas solicitações 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 ponto de sinalização.
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 ou walltimeMs. Definir os dois valores causa um erro. Se você não definir nenhum valor, o YouTube vai usar o tempo padrão insertionOffsetTimeMs (0), o que significa que o ponto de sinalização será inserido assim que 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 de época.
backendError (5xx) serviceUnavailable O serviço está indisponível. Tente fazer a solicitação novamente em alguns minutos.

liveChatBans

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

liveChatBans.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Não é possível remover a proibição especificada. Esse erro pode ocorrer se a solicitação for autorizada por um moderador que está tentando remover uma 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 Não foi possível encontrar a proibição especificada.

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 pode 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 de 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 Não foi possível encontrar o usuário do chat ao vivo que você está tentando banir.
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 as mensagens de erro que a API retorna em resposta a 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 Não é possível excluir o recurso liveChatMessage especificado. O parâmetro id pode identificar uma mensagem criada por um moderador ou outro usuário cujas mensagens não podem ser excluídas.
notFound (404) liveChatMessageNotFound Não foi possível encontrar a mensagem que você está tentando excluir. Verifique se o valor do parâmetro id 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, o que significa que 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 ocorre se a conversa foi excluída 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 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 Não foi possível encontrar o chat ao vivo que você está tentando recuperar. Verifique se o valor do parâmetro liveChatId da solicitação está correto.
rateLimitExceeded rateLimitExceeded A solicitação foi enviada muito rápido após a anterior. Esse erro ocorre quando as solicitações de API para recuperar mensagens são enviadas com mais frequência do que as taxas de atualização do YouTube, o que desperdiça largura de banda desnecessariamente.

liveChatMessages.streamlist

Tipo de erro Detalhe do erro Descrição
INVALID_ARGUMENT (3) LIVE_CHAT_ENDED Não é possível recuperar mensagens de um chat ao vivo encerrado.
PERMISSION_DENIED (7) forbidden Você não tem as permissões necessárias para recuperar mensagens do chat ao vivo especificado.
PERMISSION_DENIED (7) liveChatDisabled O chat ao vivo não está ativado para a transmissão especificada.
PERMISSION_DENIED (7) liveChatEnded O chat ao vivo especificado não está mais ativo.
NOT_FOUND (5) liveChatNotFound Não foi possível encontrar o chat ao vivo que você está tentando recuperar. Verifique se o valor do parâmetro liveChatId da solicitação está correto.
RESOURCE_EXHAUSTED (8) rateLimitExceeded A solicitação foi enviada muito rápido após a anterior. Esse erro ocorre quando as solicitações de API para recuperar mensagens são enviadas com mais frequência do que as taxas de atualização do YouTube, o que desperdiça largura de banda desnecessariamente.

liveStreams

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

liveStreams.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) liveStreamDeletionNotAllowed Não é possível excluir a transmissão ao vivo especificada porque ela 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 Implementar a autenticação do OAuth 2.0.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos 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 No momento, o usuário que autorizou a solicitação não pode transmitir vídeos ao vivo no YouTube. Os detalhes que explicam por que o usuário não pode transmitir vídeos ao vivo podem estar disponíveis nas configurações do canal em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações 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 muitas solicitações em um determinado período.
required (400) cdnRequired O recurso liveStream precisa conter o objeto cdn.
required (400) frameRateRequired A API retorna esse erro se você especificar um valor para a propriedade cdn.resolution, mas não para a propriedade cdn.frameRate.
required (400) ingestionTypeRequired O recurso liveStream precisa especificar um valor para a propriedade cdn.ingestionType>.
required (400) resolutionRequired A API retorna esse erro se você especificar um valor para a propriedade cdn.frameRate, mas não para a propriedade 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 tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações 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 Ciclo de vida de uma transmissão.
forbidden (403) liveStreamModificationNotAllowed A API não permite mudar o valor dos campos cdn.format, cdn.frameRate, cdn.ingestionType ou cdn.resolution depois que o fluxo é criado.
forbidden (403) liveStreamModificationNotAllowed A API não permite mudar um fluxo 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 Implementar a autenticação OAuth2.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não tem permissão para transmitir vídeos ao vivo no YouTube. O usuário pode encontrar mais informações 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) invalidTitle O valor da propriedade snippet.title no recurso liveStream 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.