LiveStreams

O recurso liveStream contém informações sobre o stream de vídeo que você está transmitindo para o YouTube. O stream fornece o conteúdo que será transmitido para os usuários do YouTube. Depois de criado, o recurso liveStream pode ser vinculado a um ou mais recursos liveBroadcast.

Métodos

A API é compatível com os seguintes métodos para recursos liveStreams:

list

Retorna uma lista de streams de vídeo que correspondem aos parâmetros de solicitação da API. Faça um teste agora.

inserir

Cria um stream de vídeo. O stream permite que você envie seu vídeo ao YouTube para que ele o transmita ao público. Faça um teste agora.

update

Atualiza um stream de vídeo. Se as propriedades que você quer alterar não puderem ser atualizadas, crie um novo stream com as configurações adequadas. Faça um teste agora.

delete

Exclui um stream de vídeo. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um recurso liveStreams:

{
  "kind": "youtube#liveStream",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "isDefaultStream": boolean
  },
  "cdn": {
    "ingestionType": string,
    "ingestionInfo": {
      "streamName": string,
      "ingestionAddress": string,
      "backupIngestionAddress": string
    },
    "resolution": string,
    "frameRate": string
  },
  "status": {
    "streamStatus": string,
    "healthStatus": {
      "status": string,
      "lastUpdateTimeSeconds": unsigned long,
      "configurationIssues": [
        {
          "type": string,
          "severity": string,
          "reason": string,
          "description": string
        }
      ]
    }
  },
  "contentDetails": {
    "closedCaptionsIngestionUrl": string,
    "isReusable": boolean
  }
}

Propriedades

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
kind	string Identifica o tipo do recurso da API. O valor será youtube#liveStream.
etag	etag A ETag deste recurso.
id	string O ID que o YouTube atribui para identificar a transmissão de forma exclusiva.
snippet	object O objeto snippet contém detalhes básicos sobre a transmissão, incluindo o canal, o título e a descrição.
snippet.publishedAt	datetime A data e a hora em que o stream foi criado. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).
snippet.channelId	string O ID que o YouTube usa para identificar de forma exclusiva o canal que está transmitindo a transmissão.
snippet.title	string O título do stream. O valor precisa ter entre 1 e 128 caracteres.
snippet.description	string A descrição do stream. O valor não pode ter mais de 10.000 caracteres.
snippet.isDefaultStream	boolean Esta propriedade será descontinuada a partir de 1o de setembro de 2020. Quando isso acontecer, o YouTube vai deixar de criar uma transmissão e uma transmissão padrão. Para mais detalhes, consulte o comunicado de descontinuação. Esta propriedade indica se o stream é o fluxo padrão do canal. Como funcionam as transmissões padrão Quando um canal do YouTube está ativado para transmissão ao vivo, o YouTube cria uma transmissão e uma transmissão padrão para o canal. O stream define como o proprietário do canal envia vídeo ao vivo para o YouTube, e a transmissão é como os espectadores podem ver a transmissão padrão. O proprietário do canal pode usar os métodos liveStreams.list e liveBroadcasts.list para identificar esses recursos. O stream padrão do canal existe por tempo indeterminado, não tem um horário de início ou término associado e não pode ser excluído. O proprietário do canal só precisa começar a enviar bits de vídeo, e a transmissão continua automaticamente. Quando a transmissão termina, o YouTube converte a transmissão concluída em um vídeo do YouTube e atribui um ID a ele. Após a conclusão da conversão, o vídeo é incluído na lista de vídeos enviados do canal. O vídeo não estará disponível imediatamente após a conclusão da transmissão, e a duração do atraso estará relacionada à duração real da transmissão.
cdn	object O objeto cdn define as configurações da rede de fornecimento de conteúdo (CDN) da transmissão ao vivo. Essas configurações fornecem detalhes sobre a maneira como você transmite seu conteúdo para o YouTube.
cdn.format	string Essa propriedade foi descontinuada desde 18 de abril de 2016 e não terá mais suporte a partir de 17 de agosto de 2020. As solicitações que ainda usarem essa propriedade até essa data vão falhar. Em vez disso, use as propriedades cdn.frameRate e cdn.resolution para especificar o frame rate e a resolução separadamente.
cdn.ingestionType	string O método ou protocolo usado para transmitir o stream de vídeo. Os valores válidos para essa propriedade são: dash hls rtmp (incluindo RTMPS)
cdn.ingestionInfo	object O objeto ingestionInfo contém informações que o YouTube fornece para transmitir o conteúdo ao YouTube.
cdn.ingestionInfo.streamName	string O nome da transmissão que o YouTube atribui à transmissão de vídeo.
cdn.ingestionInfo.ingestionAddress	string O URL de processamento principal que precisa ser usado para fazer streaming de vídeo no YouTube com RTMP, DASH ou HLS. É preciso fazer streaming de vídeo para esse URL. Dependendo do aplicativo ou da ferramenta usado para codificar seu stream de vídeo, talvez seja necessário inserir o URL e o nome do stream separadamente ou os concatenar no seguinte formato: STREAM_URL/STREAM_NAME
cdn.ingestionInfo.backupIngestionAddress	string O URL de processamento de backup que deve ser usado para fazer streaming de vídeo no YouTube se você usar RTMP, DASH ou HLS. Você tem a opção de transmitir simultaneamente o conteúdo que você está enviando ao ingestionAddress para esse URL.
cdn.ingestionInfo.rtmpsIngestionAddress	string O principal URL de ingestão que deve ser usado para fazer streaming de vídeo no YouTube se você usa o RTMPS. É preciso fazer streaming de vídeo para esse URL. Dependendo do aplicativo ou da ferramenta usado para codificar o stream de vídeo, talvez seja necessário inserir o URL e o nome do stream separadamente ou as concatenar no seguinte formato: STREAM_URL/STREAM_NAME
cdn.ingestionInfo.rtmpsBackupIngestionAddress	string O URL de processamento de backup que deve ser usado para fazer streaming de vídeo no YouTube se você usa o RTMPS.
cdn.resolution	string A resolução dos dados de vídeo de entrada. Os valores válidos para essa propriedade são: 240p 360p 480p 720p 1080p 1440p 2160p variable: use esta configuração para indicar que o YouTube detectará automaticamente a resolução do vídeo transmitido. Também é necessário definir cdn.frameRate como variable. Consulte as configurações de codificação recomendadas na Central de Ajuda do YouTube.
cdn.frameRate	string O frame rate dos dados de vídeo de entrada. Os valores válidos para essa propriedade são: 30fps 60fps variable: use esta configuração para indicar que o YouTube detectará automaticamente o frame rate do vídeo transmitido. Também é necessário definir cdn.resolution como variable. Consulte as configurações de codificação recomendadas na Central de Ajuda do YouTube.
status	object O objeto status contém informações sobre o status da transmissão ao vivo.
status.streamStatus	string O status da transmissão. Os valores válidos para esta propriedade são: active: o stream está no estado ativo, o que significa que o usuário está recebendo dados por ele. created: o stream foi criado, mas não tem configurações de CDN válidas. error: há uma condição de erro no stream. inactive: o stream está no estado inativo, o que significa que o usuário não está recebendo dados por ele. ready: o stream tem configurações válidas de CDN.
status.healthStatus	object Esse objeto contém informações sobre o status de integridade da transmissão ao vivo, que podem ser usadas para identificar, diagnosticar e resolver problemas de streaming.
status.healthStatus.status	string O código de status desta transmissão. Os valores válidos para esta propriedade são: good: não há problemas de configuração em que a gravidade é warning ou pior. ok: não há problemas de configuração em que a gravidade é error. bad: há problemas em que a transmissão está error. noData: os servidores de back-end de transmissão ao vivo do YouTube não têm informações sobre o status de integridade da transmissão.
status.healthStatus.lastUpdateTimeSeconds	unsigned long A última vez que o status de integridade da transmissão foi atualizado. O valor reflete um carimbo de data/hora UNIX em segundos.
status.healthStatus.configurationIssues[]	list Esse objeto contém uma lista de problemas de configuração que afetam o stream.
status.healthStatus.configurationIssues[].type	string Identifica o tipo de erro que afeta o stream. Veja valores válidos Problemas de configuração audioBitrateHigh Motivo: Verifique as configurações de áudio Descrição: A taxa de bits do stream de áudio atual de %(actual) é maior do que a recomendada. Recomendamos que você use uma taxa de bits de stream de áudio de %(expected)s. audioBitrateLow Motivo: Verifique as configurações de áudio Descrição: A taxa de bits do stream de áudio (%(actual)s) é menor do que a recomendada. Recomendamos que você use uma taxa de bits de stream de áudio de %(expected)s. audioBitrateMismatch Motivo: Verifique a transmissão secundária Descrição: Na configuração atual, os streams principal e de backup do vídeo têm taxas de bits de áudio diferentes. Você precisa configurar os streams para que tenham a mesma taxa de bits de áudio. audioCodec Motivo: Verifique as configurações de áudio Descrição: O codec da transmissão de áudio é incompatível. Ajuste o codec de áudio da transmissão para um formato compatível (AAC, MP3). audioCodecMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams principal e de backup do vídeo usam diferentes codecs de áudio. Você precisa configurar os streams para usar o mesmo codec de áudio. audioSampleRate Motivo: Verifique as configurações de áudio Descrição: A taxa de amostragem atual é %(actual). As taxas de amostragem recomendadas são de 44,1 kHz e 48 kHz. audioSampleRateMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams principal e de backup do vídeo têm taxas de amostragem de áudio diferentes. Você precisa configurar os streams para que tenham a mesma taxa de amostragem de áudio. audioStereoMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams primário e de backup estão com canais de áudio diferentes. Defina o mesmo canal de áudio para eles. audioTooManyChannels Motivo: Verifique as configurações de áudio Descrição: O áudio tem mais de dois canais, mas apenas um (mono) ou dois (estéreo) são compatíveis. Corrija o número de canais de áudio. badContainer Motivo: Configurações de vídeo inválidas Descrição: Altere o formato de contêiner do vídeo. O formato atual do contêiner não está correto para essa configuração. bitrateHigh Motivo: Verifique as configurações de vídeo Descrição: A taxa de bits do stream (%(actual)s) atual é maior do que a recomendada. Recomendamos que você use uma taxa de bits de stream de %(expected)s. bitrateLow Motivo: Saída de vídeo baixa Descrição: A taxa de bits do stream (%(actual)s) atual é menor do que a recomendada. Recomendamos que você use uma taxa de bits de stream de %(expected)s. framerateMismatch Motivo: Verifique a transmissão secundária Descrição: Na configuração atual, os streams principal e de backup do vídeo têm frame rates diferentes. Você precisa configurar os streams para que tenham o mesmo frame rate. frameRateHigh Motivo: Frame rate alto Descrição: O frame rate atual é muito alto. Defina o frame rate para %(framerate)s qps ou menos. gopMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams principal e de backup do vídeo têm frequências diferentes de frame-chave. Você precisa configurar os streams para que tenham a mesma frequência de frames-chave. gopSizeLong Motivo: Configurações de vídeo inválidas Descrição: Utilize uma frequência de frames-chave de quatro segundos ou menos. Atualmente, os keyframes não são enviados em uma frequência regular, o que pode gerar armazenamento em buffer. A frequência atual de frame-chave é %(actual_gop).1f segundos. Erros de processamento podem gerar tamanhos incorretos do grupo de imagens (GOP, na sigla em inglês). gopSizeOver Motivo: Verifique as configurações de vídeo Descrição: Utilize uma frequência de frames-chave de quatro segundos ou menos. Atualmente eles não são enviados em uma frequência regular, o que pode gerar armazenamento em buffer. A frequência atual de frame-chave é %(actual_gop).1f segundos. Erros de processamento podem gerar tamanhos incorretos do grupo de imagens (GOP, na sigla em inglês). gopSizeShort Motivo: Verifique as configurações de vídeo Descrição: O GOP é muito pequeno, o que pode prejudicar a qualidade da imagem. A configuração recomendada é de quatro segundos. A frequência atual de frame-chave é %(actual_gop).1f segundos. Os erros de processamento podem gerar tamanhos incorretos de GOP. multipleAudioStreams Motivo: Verifique as configurações de áudio Descrição: O stream de processamento contém vários streams de áudio, porém, é necessário que ele contenha somente um stream de áudio. multipleVideoStreams Motivo: Configurações de vídeo inválidas Descrição: O stream de processamento contém vários streams de vídeo, porém, é necessário que ele contenha somente um stream de vídeo. noAudioStream Motivo: Sem áudio Descrição: O stream de processamento não contém streams de áudio, porém, é necessário que ele contenha exatamente um stream de áudio. noVideoStream Motivo: Nenhum vídeo Descrição: O stream de processamento não contém streams de vídeo, porém, é necessário que ele contenha exatamente um stream de vídeo. openGop Motivo: Configurações de vídeo inválidas Descrição: Altere a configuração do codificador de vídeo para "Grupo fechado de imagens (GOP, na sigla em inglês)". Parece que ele está definido como "GOP aberto", o que não é compatível com o YouTube. resolutionMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams principal e de backup do vídeo têm resoluções diferentes. Você precisa configurar os streams para que tenham a mesma resolução. videoBitrateMismatch Motivo: Verifique a transmissão secundária Descrição: Na configuração atual, os streams principal e de backup do vídeo têm taxas de bits de vídeo diferentes. Você precisa configurar os streams para que tenham a mesma taxa de bits de vídeo. videoCodec Motivo: Configurações de vídeo inválidas Descrição: A transmissão foi codificada de forma incompatível. Ajuste o codec da transmissão de vídeo para um formato compatível (H.264). videoCodecMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams principal e de backup do vídeo usam codecs de vídeo diferentes. Você precisa configurar os streams para que tenham os mesmos codecs de vídeo. videoIngestionStarved Motivo: Saída de vídeo baixa Descrição: O YouTube não está recebendo vídeos suficientes para manter um streaming contínuo. Por isso, os espectadores terão armazenamento em buffer. videoInterlaceMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams principal e de backup do vídeo têm entrelaçamentos diferentes. Você precisa configurar os streams para que tenham o mesmo entrelaçamento. videoProfileMismatch Motivo: Stream secundário inválido Descrição: Na configuração atual, os streams principal e de backup do vídeo têm perfis diferentes. Você precisa configurar os streams para que tenham o mesmo perfil. videoResolutionSuboptimal Motivo: Verificar resolução Descrição: Verifique a resolução do vídeo. A resolução atual é (%(actual_w)dx%(actual_h)d), o que não é ideal. videoResolutionUnsupported Motivo: Resolução incompatível Descrição: Você precisa mudar a resolução do conteúdo. A resolução atual é (%(actual_w)dx%(actual_h)d), o que não é compatível com essa configuração. A resolução de vídeo esperada é (%(expected_w)dx%(expected_h)d).
status.healthStatus.configurationIssues[].severity	string Indica a gravidade do problema no stream. Os valores válidos para essa propriedade são: info – O vídeo é transmitido para os espectadores sem prejudicar o desempenho. warning – O vídeo é transmitido para os espectadores, mas o desempenho não é o ideal. error – O vídeo não pode ser transmitido para os espectadores.
status.healthStatus.configurationIssues[].reason	string Uma breve descrição do problema. O documento Problemas de configuração dos recursos de transmissão ao vivo identifica o motivo associado a cada tipo de problema de configuração.
status.healthStatus.configurationIssues[].description	string Uma descrição detalhada do problema. Quando possível, a descrição inclui informações sobre como resolver o problema. O documento Problemas de configuração dos recursos de transmissão ao vivo lista todos os tipos de problema de configuração e as descrições associadas a eles.
contentDetails	object O objeto content_details contém informações sobre o stream, incluindo o URL de processamento de legendas.
contentDetails.closedCaptionsIngestionUrl	string O URL de processamento para onde as closed captions do stream são enviadas.
contentDetails.isReusable	boolean Indica se o stream é reutilizável, o que significa que pode ser vinculado a várias transmissões. É comum que as emissoras reutilizem o mesmo stream para muitas transmissões diferentes se elas ocorrerem em momentos diferentes. Se você definir esse valor como false, o stream não será reutilizável, o que significa que ele só pode ser vinculado a uma transmissão. Os streams não reutilizáveis têm algumas diferenças em relação aos streams reutilizáveis: Um stream não reutilizável só pode ser vinculado a uma transmissão. Um stream não reutilizável pode ser excluído por um processo automatizado após o término da transmissão. O método liveStreams.list não lista os streams não reutilizáveis se você chamar o método e definir o parâmetro mine como true. A única maneira de usar esse método para recuperar o recurso de uma transmissão não reutilizável é usar o parâmetro id para identificar o fluxo.