LiveBroadcasts

Zasób liveBroadcast reprezentuje wydarzenie, które będzie transmitowane w YouTube za pomocą transmisji na żywo.

Metody

Interfejs API obsługuje te metody dotyczące zasobów liveBroadcasts:

list

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

insert

Tworzy transmisję. Wypróbuj teraz

update

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

usuń

Usuwanie transmisji. Wypróbuj teraz

bind

Przywiązuje transmisję w YouTube do strumienia lub usuwa istniejące powiązanie między transmisją a strumieniem. Transmisja może być powiązana tylko z 1 strumieniem wideo, ale strumień wideo może być powiązany z wieloma transmisjami. Wypróbuj teraz

transition

Zmienia stan transmisji na żywo w YouTube i inicjuje procesy związane z nowym stanem. Gdy na przykład zmienisz stan transmisji na testing, YouTube zacznie przesyłać film do strumienia monitorowania tej transmisji. Przed wywołaniem tej metody musisz potwierdzić, że wartość właściwości status.streamStatus dla strumienia powiązanego z Twoim przekazem wynosi active. Wypróbuj

cuepoint

Wstawia punkt cue w transmisji na żywo. Sygnał może wywołać przerwę na reklamę.

Prezentacja zasobów

Struktura JSON poniżej 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

Właściwości występujące w tym zasobie są opisane w tabeli poniżej: