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.

FunFundingEvents

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

fanFundingEvents.list

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

transmissões ao vivo

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de 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 fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 muitas solicitações em um determinado período.
required (400) idRequired O parâmetro id obrigatório precisa identificar a transmissão para vincular.

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 fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 do usuário em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 de 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 contém 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 contém um valor inválido para a propriedade status.privacy_status.
invalidValue (400) invalidProjection O recurso liveBroadcast contém 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 contém 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 contém um valor inválido para a propriedade snippet.scheduledStartTime. A hora de início programada precisa estar no futuro e estar próxima o suficiente da data atual em que uma 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 interromper ou excluir algumas.
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. Veja os valores de 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 está habilitado para fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 fazer a transição do status atual para o status solicitado.
forbidden (403) redundantTransition A transmissão ao vivo já está no status solicitado ou sendo processada.
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 do usuário em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 id obrigatório precisa identificar a transmissão com o status que você quer transferir.
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 estiver 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 for created ou ready.
forbidden (403) enableMonitorStreamModificationNotAllowed O valor contentDetails.monitorStream.enableMonitorStream só pode ser modificado quando o status da transmissão for created ou ready.
forbidden (403) recordFromStartModificationNotAllowed O valor contentDetails.recordFromStart só pode ser modificado quando o status da transmissão for 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 fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 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 de 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 conter até 5.000 caracteres.
invalidValue (400) invalidEmbedSetting O recurso liveBroadcast contém 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 somente 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. Veja os valores de privacyStatus válidos.
invalidValue (400) invalidProjection O recurso liveBroadcast contém 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 contém 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 contém 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 para ver valores de privacyStatus válidos.
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 tem autorização para inserir um marcador na transmissão ao vivo.
insufficientPermissions (403) liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para fazer streaming de vídeo 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 obrigatório id precisa identificar a transmissão em que você quer inserir um marcador.
required (400) cueTypeRequired O campo obrigatório cueType precisa ser especificado no corpo da solicitação de API.
notFound (404) liveBroadcastNotFound A transmissão especificada pelo parâmetro id não existe.
invalidValue (400) conflictingTimeFields Somente uma das opções insertionOffsetTimeMs e walltimeMs pode ser especificada. Definir os dois valores causa um erro. Se nenhum valor for definido, o YouTube usará o horário padrão de insertionOffsetTimeMs (0). Isso 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 de época.
backendError (5xx) serviceUnavailable O serviço está indisponível. Tente novamente em alguns minutos.

LiveChatBans

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

liveChatBans.delete

Tipo de erro Detalhe do erro Descrição
forbidden (403) forbidden Não é possível remover a proibição especificada. Este erro pode ocorrer se a solicitação é 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 A proibição especificada não foi 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 O ID do canal especificado não foi encontrado.
invalidValue (400) invalidLiveChatId O valor snippet.liveChatId especificado na solicitação é inválido. Verifique o recurso liveBroadcast associado para garantir que você tem 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ê esteja 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.

mensagens ao vivo do chat

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de 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 cujas mensagens não podem ser excluídas.
notFound (404) liveChatMessageNotFound A mensagem que você está tentando excluir não foi 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, o que significa que não é possível adicionar mensagens.
forbidden (403) liveChatEnded O chat ao vivo especificado não está mais ao vivo.
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 de API não existe. Esse erro vai ocorrer se o chat 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 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 ao vivo.
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 esteja correto.
rateLimitExceeded rateLimitExceeded A solicitação foi enviada muito rapidamente depois da 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 gera desperdício de largura de banda.

Pontos dinâmicos

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

liveCuepoints.insert

Tipo de erro Detalhe do erro Descrição
invalidValue (400) conflictingTimeFields Somente uma entre offsetTimeMs e walltime pode ser especificada.

transmissões ao vivo

As tabelas a seguir identificam mensagens de erro que a API retorna em resposta às chamadas relacionadas aos recursos de 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 tem autorização para 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 fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse https://www.youtube.com/features.
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 tem autorização para 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 do usuário em https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled O usuário que autorizou a solicitação não está habilitado para fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 retornará 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 retornará 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 está habilitado para fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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 em seu estado atual. Para saber mais, consulte Vida útil 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 após a criação do stream.
forbidden (403) liveStreamModificationNotAllowed A API não permite que um fluxo reutilizável seja alterado para não reutilizável ou vice-versa. Para saber mais, 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 fazer streaming de vídeo ao vivo no YouTube. Para ver mais informações, acesse 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.

patrocinadores

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

sponsors.list

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