LiveCuepoints

O recurso liveCuepoint e o método liveCuepoints.insert foram descontinuados e substituídos pelo método liveBroadcasts.cuepoint.

Um recurso liveCuepoint insere um marcador no stream de vídeo de transmissão, o que pode acionar um intervalo de anúncio.

Observação: esse comando da API faz parte da API Content ID do YouTube e tem requisitos de autorização diferentes das solicitações para gerenciar recursos liveBroadcast e liveStream.

Métodos

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

inserir
Insere um marcador em uma transmissão ao vivo. No momento, as solicitações para esse método precisam ser autorizadas por uma conta associada a um proprietário de conteúdo do YouTube. Faça um teste agora.

Representação de recurso

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

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

Propriedades

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

Propriedades
id string
Um valor que o YouTube atribui para identificar exclusivamente o marcador.
kind string
O tipo do recurso da API. Para recursos liveCuepoint, o valor é youtubePartner#liveCuepoint.
broadcastId string
O ID que o YouTube atribui para identificar a transmissão em que o marcador está sendo inserido.
settings object
O objeto settings define as configurações do ponto de inserção.
settings.offsetTimeMs long
Esse valor especifica um ponto no vídeo em que os espectadores precisam ver um anúncio ou uma slate in-stream. O valor da propriedade identifica um deslocamento de tempo, em milissegundos, desde o início do fluxo do monitor. Embora medido em milissegundos, o valor é uma aproximação, e o YouTube inserirá o marcador o mais próximo possível daquele tempo. Não especifique um valor para esse parâmetro se sua transmissão não tiver um fluxo de monitor.

O valor padrão dessa propriedade é 0, o que indica que o ponto de inserção precisa ser inserido o mais rápido possível. Se o stream de transmissão não estiver atrasado, 0 também será o único valor válido. No entanto, se seu stream de transmissão estiver atrasado, o valor da propriedade poderá especificar a hora em que o marcador será inserido. Consulte o guia Primeiros passos para mais detalhes.

Observação:se a transmissão tiver uma fase de teste, o deslocamento será medido a partir do momento em que a fase de teste começou.
settings.walltime datetime
Esse valor especifica o horário em que o marcador é inserido. O valor é especificado no formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

A API retornará um erro se uma solicitação tentar inserir um marcador que especifique um valor para essa propriedade e para a settings.offsetTimeMs.
settings.cueType string
O tipo do ponto de inserção. Consulte o guia Primeiros passos para ver uma explicação sobre os diferentes tipos de pontos de inserção. Consulte também o documento Vida útil de uma transmissão para ver práticas recomendadas sobre como inserir pontos de inserção durante a transmissão.

Os valores válidos para essa propriedade são os seguintes:
  • ad
settings.durationSecs unsigned integer
A duração do ponto de inserção em segundos. Esse valor precisará ser especificado se cueType for ad. Caso contrário, será ignorado.