LiveCuepoints

El recurso liveCuepoint y el método liveCuepoints.insert dejaron de estar disponibles y se reemplazaron por el método liveBroadcasts.cuepoint.

Un recurso liveCuepoint inserta un punto de referencia en la transmisión de video por Internet, lo que podría activar una pausa publicitaria.

Nota: Este comando de la API es en realidad parte de la API de Content ID de YouTube y tiene requisitos de autorización diferentes a los de las solicitudes para administrar recursos liveBroadcast y liveStream.

Métodos

La API admite los siguientes métodos para los recursos de liveCuepoints:

insertar
Inserta un punto de referencia en una transmisión en vivo. Actualmente, las solicitudes para este método deben estar autorizadas por una cuenta asociada con un propietario de contenido de YouTube. Pruébala ahora.

Representación de recursos

La siguiente estructura JSON muestra el formato de un recurso liveCuepoints:

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

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
id string
Corresponde a un valor que YouTube asigna para identificar el punto de referencia de forma única.
kind string
El tipo de recurso de la API. Para los recursos de liveCuepoint, el valor es youtubePartner#liveCuepoint.
broadcastId string
ID que YouTube asigna para identificar de forma exclusiva la transmisión en la que se insertará el punto de inserción.
settings object
El objeto settings define la configuración del punto de inserción.
settings.offsetTimeMs long
Este valor especifica un momento determinado en el video en el que los usuarios deberían ver un anuncio o una lista in-stream. El valor de la propiedad identifica un desfase de tiempo, en milisegundos, desde el comienzo de la transmisión continua de monitor. Si bien se mide en milisegundos, el valor es una aproximación, y YouTube insertará el punto de referencia lo más cerca posible de ese tiempo. No debes especificar un valor para este parámetro si tu transmisión no tiene una transmisión continua de monitor.

El valor predeterminado de esta propiedad es 0, lo que indica que el punto de inserción se debe insertar lo antes posible. Si tu transmisión continua no se retrasa, 0 también es el único valor válido. Sin embargo, si la transmisión continua se retrasa, el valor de la propiedad puede especificar el momento en que se debe insertar el punto de inserción. Consulta la guía de introducción para obtener más detalles.

Nota: Si tu transmisión tenía una fase de prueba, la compensación se mide desde el momento en que comenzó la fase de prueba.
settings.walltime datetime
Este valor especifica la hora real en la que se debe insertar el punto de inserción. El valor se especifica en el formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).

La API muestra un error si una solicitud intenta insertar un punto de inserción que especifique un valor para esta propiedad y para la propiedad settings.offsetTimeMs.
settings.cueType string
Tipo de punto de inserción Consulta la guía de introducción para obtener una explicación de los diferentes tipos de puntos de inserción. Consulta también el documento Ciclo de una transmisión para conocer las prácticas recomendadas sobre la inserción de puntos de inserción durante la transmisión.

Los valores válidos para esta propiedad son los siguientes:
  • ad
settings.durationSecs unsigned integer
Duración del punto de inserción, en segundos. Este valor se debe especificar si cueType es ad y, de lo contrario, se ignora.