LiveBroadcasts

Zasób liveBroadcast reprezentuje wydarzenie, które będzie transmitowane strumieniowo w YouTube w formie transmisji na żywo.

Metody

Interfejs API obsługuje te metody w przypadku zasobów liveBroadcasts:

list

Zwraca listę transmisji z YouTube, które pasują do parametrów żądania do interfejsu API. Wypróbuj teraz

wstaw

Tworzy transmisję. Wypróbuj teraz

aktualizacja

Aktualizuje transmisję. Można na przykład zmodyfikować ustawienia emisji zdefiniowane w obiekcie contentDetails zasobu liveBroadcast. Wypróbuj teraz

usuń

Usuwa transmisję. Wypróbuj teraz

powiązanie

Wiąże transmisję YouTube ze strumieniem lub usuwa istniejące powiązanie między transmisją a transmisją. Transmisję można powiązać tylko z jednym strumieniem wideo, natomiast strumień wideo można powiązać z więcej niż jedną transmisją. Wypróbuj teraz

przejście

Zmienia stan transmisji na żywo w YouTube i inicjuje wszystkie procesy związane z nowym stanem. Jeśli na przykład zmienisz stan transmisji na testing, YouTube zacznie przesyłać wideo do strumienia monitorowania tej transmisji. Zanim wywołasz tę metodę, upewnij się, że wartość właściwości status.streamStatus strumienia powiązanego z transmisją wynosi active. Wypróbuj teraz

punkt wstawienia reklamy

Wstawia punkt wstawienia w transmisji na żywo. Punkt wstawienia reklamy może wywołać przerwę na reklamę.

Reprezentacja zasobu

Poniższa struktura JSON pokazuje format zasobu 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
  },
  "statistics": {
    "totalChatCount": unsigned long
  },
  "monetizationDetails": {
    "cuepointSchedule": {
      "enabled": boolean,
      "pauseAdsUntil": datetime,
      "scheduleStrategy": string,
      "repeatIntervalSecs": unsigned integer,
    }
  }
}

Właściwości

Poniższa tabela definiuje właściwości, które pojawiają się w tym zasobie: