LiveBroadcasts

Un recurso liveBroadcast representa un evento que se transmitirá mediante video en vivo en YouTube.

Métodos

La API admite los siguientes métodos para los recursos liveBroadcasts:

list

Devuelve una lista de transmisiones de YouTube que coinciden con los parámetros de la solicitud a la API. Pruébala ahora.

insertar

Crea una transmisión. Pruébala ahora.

actualizar

Actualiza una transmisión. Por ejemplo, podrías modificar la configuración de transmisión definida en el objeto contentDetails del recurso liveBroadcast. Pruébalo ahora.

borrar

Borra una transmisión. Pruébala ahora.

vincular

Vincula una emisión de YouTube a una transmisión o quita una vinculación existente entre una emisión y una transmisión. Una transmisión solo se puede vincular a una transmisión de video por Internet, aunque una transmisión de video por Internet se puede vincular a más de una transmisión. Pruébala ahora.

transition

Cambia el estado de una transmisión en vivo de YouTube y, luego, inicia los procesos asociados con el nuevo estado. Por ejemplo, cuando cambias el estado de una transmisión a testing, YouTube comienza a transmitir video al flujo de supervisión de esa transmisión. Antes de llamar a este método, debes confirmar que el valor de la propiedad status.streamStatus para la transmisión vinculada a tu emisión sea active. Pruébalo ahora.

cuepoint

Inserta un punto de referencia en una transmisión en vivo. Es posible que el punto de referencia active una pausa publicitaria.

Representación de recursos

En la siguiente estructura JSON, se muestra el formato de un recurso liveBroadcasts:

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean,
    "availabilityConfig": {
      "globalConfig": {
        "excludedRegionCodes": [
          string
        ],
        "interval": {
          "startTime": datetime,
          "endTime": datetime
        }
      },
      "regionsConfig": {
        "regionIntervals": [
          {
            "regionCode": string,
            "interval": {
              "startTime": datetime,
              "endTime": datetime
            }
          }
        ]
      }
    }
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
    "adsMonetizationStatus": string,
    "eligibleForAdsMonetization": boolean,
    "cuepointSchedule": {
      "enabled": boolean,
      "pauseAdsUntil": datetime,
      "ytOptimizedCuepointConfig": string,
      "creatorCuepointConfig": {
        "scheduleStrategy": string,
        "repeatIntervalSecs": unsigned integer
      }
    }
  }
}

Propiedades

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