LiveBroadcasts

liveBroadcast kaynağı, YouTube'da canlı video aracılığıyla yayınlanacak bir etkinliği temsil eder.

Yöntemler

API, liveBroadcasts kaynakları için aşağıdaki yöntemleri destekler:

list

API isteği parametreleriyle eşleşen YouTube yayınlarının listesini döndürür. Hemen deneyin.

ekle

Yayın oluşturur. Hemen deneyin.

güncelle

Bir yayını günceller. Örneğin, liveBroadcast kaynağının contentDetails nesnesinde tanımlanan yayın ayarlarını değiştirebilirsiniz. Hemen deneyin.

sil

Bir yayını siler. Hemen deneyin.

bağla

YouTube yayınını akışa bağlar veya yayın ile yayın arasındaki mevcut bir bağlantıyı kaldırır. Bir yayın yalnızca bir video akışına bağlanabilir, ancak bir video akışı birden fazla yayına bağlı olabilir. Hemen deneyin.

geçiş

YouTube canlı yayınının durumunu değiştirir ve yeni durumla ilişkili tüm işlemleri başlatır. Örneğin, bir yayının durumunu testing olarak değiştirdiğinizde YouTube videoyu söz konusu yayının monitör akışına aktarmaya başlar. Bu yöntemi çağırmadan önce, yayınınıza bağlı akış için status.streamStatus özelliğinin değerinin active olduğunu onaylamanız gerekir. Hemen deneyin.

işaret noktası

Canlı yayına bir işaret noktası ekler. İşaret noktası bir reklam arasını tetikleyebilir.

Kaynak temsili

Aşağıdaki JSON yapısı, bir liveBroadcasts kaynağının biçimini gösterir:

{
  "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,
    }
  }
}

Özellikler

Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır: