LiveBroadcasts | YouTube Live Streaming API

<!doctype html> <html lang="en" dir="ltr"> <head><script type="text/javascript" src="/_static/js/bundle-playback.js?v=HxkREWBo" charset="utf-8"></script> <script type="text/javascript" src="/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://developers.google.com/youtube/v3/live/docs/liveBroadcasts","20211122121323","https://web.archive.org/","web","/_static/", "1637583203"); </script> <link rel="stylesheet" type="text/css" href="/_static/css/banner-styles.css?v=S1zqJCYt" /> <link rel="stylesheet" type="text/css" href="/_static/css/iconochive.css?v=3PDvdIFv" />  <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#ff0000"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/web/20211122121323/https://developers.google.com/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//web.archive.org/web/20211122121323/https://www.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211122121323/https://fonts.gstatic.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211122121323/https://fonts.googleapis.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211122121323/https://apis.google.com/" crossorigin> <link rel="preconnect" href="//web.archive.org/web/20211122121323/https://www.google-analytics.com/" crossorigin><link rel="stylesheet" href="//web.archive.org/web/20211122121323cs_/https://fonts.googleapis.com/css?family=Google+Sans_old:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//web.archive.org/web/20211122121323cs_/https://fonts.googleapis.com/css?family=Material+Icons&display=block"><link rel="stylesheet" href="https://web.archive.org/web/20211122121323cs_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/css/app.css"> <link rel="shortcut icon" href="https://web.archive.org/web/20211122121323im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/favicon.png"> <link rel="apple-touch-icon" href="https://web.archive.org/web/20211122121323im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/touchicon-180.png"><link rel="canonical" href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts"><link rel="search" type="application/opensearchdescription+xml" title="Google Developers" href="https://web.archive.org/web/20211122121323/https://developers.google.com/s/opensearch.xml"> <title>LiveBroadcasts  |  YouTube Live Streaming API  |  Google Developers</title> <meta property="og:title" content="LiveBroadcasts | YouTube Live Streaming API | Google Developers"><meta property="og:url" content="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts"><meta property="og:image" content="https://web.archive.org/web/20211122121323im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/opengraph/youtube-theme.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://web.archive.org/web/20211122121323/https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "YouTube", "item": "https://web.archive.org/web/20211122121323/https://developers.google.com/youtube" },{ "@type": "ListItem", "position": 2, "name": "Live Streaming API", "item": "https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/getting-started" },{ "@type": "ListItem", "position": 3, "name": "LiveBroadcasts", "item": "https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts" }] } </script> </head> <body class="docs" template="page" theme="youtube-theme" type="reference" layout="docs" pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"><devsite-header> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20211122121323im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Product breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube"> YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/getting-started" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Live Streaming API"> Live Streaming API </a> </li> </ul> </span> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> </div> <devsite-search aria-expanded="false" aria-haspopup="listbox" enable-signin enable-search enable-suggestions enable-query-completion project-name="YouTube Live Streaming API" tenant-name="Google Developers" project-scope="/youtube/v3/live/getting-started" url-scoped="https://developers.google.com/s/results/youtube/v3/live/getting-started" role="combobox"> <form class="devsite-search-form" action="https://web.archive.org/web/20211122121323/https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-haspopup="false" aria-multiline="false" aria-label="Search box" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="searchbox" type="text" value=""> <div class="devsite-search-image material-icons" aria-hidden="true"></div> </div> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en"> English </option> <option value="id" lang="id"> Bahasa Indonesia </option> <option value="de" lang="de"> Deutsch </option> <option value="es" lang="es"> Español </option> <option value="fr" lang="fr"> Français </option> <option value="pt_br" lang="pt_br"> Português – Brasil </option> <option value="ru" lang="ru"> Русский </option> <option value="zh_cn" lang="zh_cn"> 中文 – 简体 </option> <option value="ja" lang="ja"> 日本語 </option> <option value="ko" lang="ko"> 한국어 </option> </select> </devsite-select> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> <span class="button devsite-top-button" aria-hidden="true" visually-hidden>Sign in</span> </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section "> <div class="devsite-header-background"> <div class="devsite-doc-set-nav-row"> <devsite-tabs class="lower-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Lower tabs"> <tab> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/getting-started" class="gc-analytics-event " track-type="nav" track-name="guides" track-metadata-eventdetail="https://developers.google.com/youtube/v3/live/getting-started" track-metadata-position="nav - guides" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Guides"> Guides </a> </tab> <tab active> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/docs" class="gc-analytics-event " track-type="nav" track-name="reference" track-metadata-eventdetail="https://developers.google.com/youtube/v3/live/docs" track-metadata-position="nav - reference" track-metadata-module="primary nav" aria-label="Reference, selected" data-category="Site-Wide Custom Events" data-label="Tab: Reference"> Reference </a> </tab> <tab> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/code_samples" class="gc-analytics-event " track-type="nav" track-name="samples" track-metadata-eventdetail="https://developers.google.com/youtube/v3/live/code_samples" track-metadata-position="nav - samples" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Samples"> Samples </a> </tab> <tab> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/support" class="gc-analytics-event " track-type="nav" track-name="support" track-metadata-eventdetail="https://developers.google.com/youtube/v3/live/support" track-metadata-position="nav - support" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Support"> Support </a> </tab> </nav> </devsite-tabs> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube"> <div class="devsite-product-logo-container" size="medium"> <img class="devsite-product-logo" alt="YouTube" src="https://web.archive.org/web/20211122121323im_/https://developers.google.com/site-assets/logo-youtube.svg" srcset="" sizes="64px" loading="lazy"> </div> </a> <span class="devsite-product-name"> <ul class="devsite-breadcrumb-list" aria-label="Upper header breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="YouTube"> YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/getting-started" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="YouTube Live Streaming API"> Live Streaming API </a> </li> </ul> </span> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/getting-started" class="devsite-nav-title gc-analytics-event devsite-nav-has-children " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Guides" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="guides"> <span class="devsite-nav-text" tooltip> Guides </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Reference" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="reference"> <span class="devsite-nav-text" tooltip> Reference </span> <span class="devsite-nav-icon material-icons" data-icon="forward"> </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/code_samples" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Samples" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="samples"> <span class="devsite-nav-text" tooltip> Samples </span> </a> </li> <li class="devsite-nav-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/support" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Responsive Tab: Support" track-type="navMenu" track-metadata-eventdetail="globalMenu" track-metadata-position="nav" track-name="support"> <span class="devsite-nav-text" tooltip> Support </span> </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom" role="navigation"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Resource Summary</span></a></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>LiveBroadcasts</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/bind" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>bind</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/transition" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>transition</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/control" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>control</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>LiveChatBans</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatBans" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatBans/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatBans/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>LiveChatMessages</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatMessages" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatMessages/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatMessages/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatMessages/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>LiveChatModerators</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatModerators" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatModerators/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatModerators/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatModerators/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>LiveCuepoints</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveCuepoints" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveCuepoints/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>LiveStreams</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams/insert" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>insert</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams/update" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>update</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams/delete" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>delete</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable devsite-nav-deprecated"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>Sponsors</span><span class="devsite-nav-icon material-icons" data-icon="deprecated" data-title="Deprecated" aria-hidden="true"></span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/sponsors" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/sponsors/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>SuperChatEvents</span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/superChatEvents" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/superChatEvents/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-expandable devsite-nav-deprecated"><devsite-expandable-nav collapsed> <a class="devsite-nav-toggle" aria-hidden="true"></a><div class="devsite-nav-title devsite-nav-title-no-path" tabindex="0" role="button"><span class="devsite-nav-text" tooltip>FanFundingEvents</span><span class="devsite-nav-icon material-icons" data-icon="deprecated" data-title="Deprecated" aria-hidden="true"></span></div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/fanFundingEvents" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Overview</span></a></li><li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/fanFundingEvents/list" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>list</span></a></li></ul></devsite-expandable-nav></li> <li class="devsite-nav-item devsite-nav-break"></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"><span class="devsite-nav-text" tooltip>Error Handling</span></div></li> <li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/errors" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>YouTube Live Streaming API Errors</span></a></li> <li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams/health_status_messages" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Live Stream Configuration Issues</span></a></li> <li class="devsite-nav-item devsite-nav-break"></li> <li class="devsite-nav-item"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/revision_history" class="devsite-nav-title"><span class="devsite-nav-text" tooltip>Revision History</span></a></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav has-sidebar> <div class="devsite-sidebar"> <div class="devsite-sidebar-content"> <devsite-toc class="devsite-nav" role="navigation" aria-label="On this page" depth="2" scrollbars></devsite-toc> <devsite-recommendations-sidebar class="nocontent devsite-nav"> </devsite-recommendations-sidebar> </div> </div> <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail=""> Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail=""> Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="YouTube"> YouTube </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/getting-started" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="YouTube Live Streaming API"> Live Streaming API </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/youtube/v3/live/docs" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="5" track-type="globalNav" track-name="breadcrumb" track-metadata-position="5" track-metadata-eventdetail=""> Reference </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <h1 class="devsite-page-title">LiveBroadcasts</h1> <devsite-bookmark></devsite-bookmark> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded> </devsite-toc> <devsite-recommendations-dropdown class="nocontent"></devsite-recommendations-dropdown> <div class="devsite-article-body clearfix "> <div itemscope itemtype="http://developers.google.com/ReferenceObject"> <meta itemprop="name" content="liveBroadcasts"/> <div class="note"> The API now supports the ability to mark your <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts">live broadcasts</a> as "made for kids," and the <code translate="no" dir="ltr">liveBroadcast</code> resource now contains a property that identifies the "made for kids" status of that live broadcast. The YouTube API Services Terms of Service and Developer Policies were also updated on 10 January 2020. For more information, please see the revision histories for the <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/revision_history">YouTube Live Streaming API Service</a> and the <a href="/web/20211122121323/https://developers.google.com/youtube/terms/revision-history">YouTube API Services Terms of Service</a>. </div> <section id="overview"> <p>A <code translate="no" dir="ltr"><strong>liveBroadcast</strong></code> resource represents an event that will be streamed, via live video, on YouTube.</p> </section> <section id="methods"> <h2 id="methods" data-text="Methods">Methods</h2> <p>The API supports the following methods for <code translate="no" dir="ltr">liveBroadcasts</code> resources:</p> <dl> <dt class="notranslate"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/list">list</a></dt> <dd>Returns a list of YouTube broadcasts that match the API request parameters. <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/list#try-it">Try it now</a>.</dd> <dt class="notranslate"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert</a></dt> <dd>Creates a broadcast. <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert#try-it">Try it now</a>.</dd> <dt class="notranslate"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update</a></dt> <dd>Updates a broadcast. For example, you could modify the broadcast settings defined in the <code translate="no" dir="ltr">liveBroadcast</code> resource's <code translate="no" dir="ltr">contentDetails</code> object. <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update#try-it">Try it now</a>.</dd> <dt class="notranslate"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/delete">delete</a></dt> <dd>Deletes a broadcast. <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/delete#try-it">Try it now</a>.</dd> <dt class="notranslate"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/bind">bind</a></dt> <dd>Binds a YouTube broadcast to a stream or removes an existing binding between a broadcast and a stream. A broadcast can only be bound to one video stream, though a video stream may be bound to more than one broadcast. <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/bind#try-it">Try it now</a>.</dd> <dt class="notranslate"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/transition">transition</a></dt> <dd>Changes the status of a YouTube live broadcast and initiates any processes associated with the new status. For example, when you transition a broadcast's status to <code translate="no" dir="ltr">testing</code>, YouTube starts to transmit video to that broadcast's monitor stream. Before calling this method, you should confirm that the value of the <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams#status.streamStatus">status.streamStatus</a></code> property for the stream bound to your broadcast is <code translate="no" dir="ltr">active</code>. <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/transition#try-it">Try it now</a>.</dd> <dt class="notranslate"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/control">control</a></dt> <dd>Controls the settings for a slate that can be displayed in the broadcast stream. <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/control#try-it">Try it now</a>.</dd> </dl> </section> <section id="resource"> <h2 id="resource-representation" data-text="Resource representation">Resource representation</h2> <p>The following JSON structure shows the format of a <code translate="no" dir="ltr">liveBroadcasts</code> resource:</p> <pre id="alt-json" class="prettyprint notranslate" style="max-height: 500px; overflow: auto" dir="ltr">{ "<a href="#kind">kind</a>": "youtube#liveBroadcast", "<a href="#etag">etag</a>": <var class="apiparam" translate="no">etag</var>, "<a href="#id">id</a>": <var class="apiparam" translate="no">string</var>, "<a href="#snippet">snippet</a>": { "<a href="#snippet.publishedAt">publishedAt</a>": <var class="apiparam" translate="no">datetime</var>, "<a href="#snippet.channelId">channelId</a>": <var class="apiparam" translate="no">string</var>, "<a href="#snippet.title">title</a>": <var class="apiparam" translate="no">string</var>, "<a href="#snippet.description">description</a>": <var class="apiparam" translate="no">string</var>, "<a href="#snippet.thumbnails">thumbnails</a>": { <var class="apiparam" translate="no">(key)</var>: { "<a href="#snippet.thumbnails.(key).url">url</a>": <var class="apiparam" translate="no">string</var>, "<a href="#snippet.thumbnails.(key).width">width</a>": <var class="apiparam" translate="no">unsigned integer</var>, "<a href="#snippet.thumbnails.(key).height">height</a>": <var class="apiparam" translate="no">unsigned integer</var> } }, "<a href="#snippet.scheduledStartTime">scheduledStartTime</a>": <var class="apiparam" translate="no">datetime</var>, "<a href="#snippet.scheduledEndTime">scheduledEndTime</a>": <var class="apiparam" translate="no">datetime</var>, "<a href="#snippet.actualStartTime">actualStartTime</a>": <var class="apiparam" translate="no">datetime</var>, "<a href="#snippet.actualEndTime">actualEndTime</a>": <var class="apiparam" translate="no">datetime</var>, "<a href="#snippet.isDefaultBroadcast">isDefaultBroadcast</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#snippet.liveChatId">liveChatId</a>": <var class="apiparam" translate="no">string</var> }, "<a href="#status">status</a>": { "<a href="#status.lifeCycleStatus">lifeCycleStatus</a>": <var class="apiparam" translate="no">string</var>, "<a href="#status.privacyStatus">privacyStatus</a>": <var class="apiparam" translate="no">string</var>, "<a href="#status.recordingStatus">recordingStatus</a>": <var class="apiparam" translate="no">string</var>, "<a href="#status.madeForKids">madeForKids</a>": <var class="apiparam" translate="no">string</var>, "<a href="#status.selfDeclaredMadeForKids">selfDeclaredMadeForKids</a>": <var class="apiparam" translate="no">string</var>, }, "<a href="#contentDetails">contentDetails</a>": { "<a href="#contentDetails.boundStreamId">boundStreamId</a>": <var class="apiparam" translate="no">string</var>, "<a href="#contentDetails.boundStreamLastUpdateTimeMs">boundStreamLastUpdateTimeMs</a>": <var class="apiparam" translate="no">datetime</var>, "<a href="#contentDetails.monitorStream">monitorStream</a>": { "<a href="#contentDetails.monitorStream.enableMonitorStream">enableMonitorStream</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.monitorStream.broadcastStreamDelayMs">broadcastStreamDelayMs</a>": <var class="apiparam" translate="no">unsigned integer</var>, "<a href="#contentDetails.monitorStream.embedHtml">embedHtml</a>": <var class="apiparam" translate="no">string</var> }, "<a href="#contentDetails.enableEmbed">enableEmbed</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.enableDvr">enableDvr</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.enableContentEncryption">enableContentEncryption</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.startWithSlate">startWithSlate</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.recordFromStart">recordFromStart</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.enableClosedCaptions">enableClosedCaptions</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.closedCaptionsType">closedCaptionsType</a>": <var class="apiparam" translate="no">string</var>, "<a href="#contentDetails.projection">projection</a>": <var class="apiparam" translate="no">string</var>, "<a href="#contentDetails.enableLowLatency">enableLowLatency</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.latencyPreference">latencyPreference</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.enableAutoStart">enableAutoStart</a>": <var class="apiparam" translate="no">boolean</var>, "<a href="#contentDetails.enableAutoStop">enableAutoStop</a>": <var class="apiparam" translate="no">boolean</var> }, "<a href="#statistics">statistics</a>": { "<a href="#statistics.totalChatCount">totalChatCount</a>": <var class="apiparam" translate="no">unsigned long</var> } }</pre> </section> <section id="properties"> <h3 id="properties" data-text="Properties">Properties</h3> <p>The following table defines the properties that appear in this resource:</p> <table class="responsive properties" id="property-table"> <thead> <tr> <th colspan="2">Properties</th> </tr> </thead> <tbody> <tr id="kind"> <td><code itemprop="property" translate="no" dir="ltr">kind</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> Identifies the API resource's type. The value will be <code translate="no" dir="ltr">youtube#liveBroadcast</code>.</td> </tr> <tr id="etag"> <td><code itemprop="property" translate="no" dir="ltr">etag</code></td> <td><code class="apitype notranslate" dir="ltr">etag</code><br> The Etag of this resource.</td> </tr> <tr id="id"> <td><code itemprop="property" translate="no" dir="ltr">id</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The ID that YouTube assigns to uniquely identify the broadcast.</td> </tr> <tr id="snippet"> <td><code itemprop="property" translate="no" dir="ltr">snippet</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> The <code translate="no" dir="ltr">snippet</code> object contains basic details about the event, including its title, description, start time, and end time.</td> </tr> <tr id="snippet.publishedAt"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>publishedAt</code></td> <td><code class="apitype notranslate" dir="ltr">datetime</code><br> The date and time that the broadcast was added to YouTube's live broadcast schedule. The value is specified in <a href="//web.archive.org/web/20211122121323/https://www.w3.org/TR/NOTE-datetime">ISO 8601</a> (<code translate="no" dir="ltr">YYYY-MM-DDThh:mm:ss.sZ</code>) format.</td> </tr> <tr id="snippet.channelId"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>channelId</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The ID that YouTube uses to uniquely identify the channel that is publishing the broadcast.</td> </tr> <tr id="snippet.title"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>title</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The broadcast's title. Note that the broadcast represents exactly one YouTube video. You can set this field by modifying the broadcast resource or by setting the <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/docs/videos#snippet.title">title</a></code> field of the corresponding video resource.</td> </tr> <tr id="snippet.description"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>description</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The broadcast's description. As with the <code translate="no" dir="ltr">title</code>, you can set this field by modifying the broadcast resource or by setting the <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/docs/videos#snippet.description">description</a></code> field of the corresponding video resource.</td> </tr> <tr id="snippet.thumbnails"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>thumbnails</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> A map of thumbnail images associated with the broadcast. For each nested object in this object, the key is the name of the thumbnail image, and the value is an object that contains other information about the thumbnail.</td> </tr> <tr id="snippet.thumbnails.(key)"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.thumbnails.</span>(key)</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> Valid key values are:<ul><li><code translate="no" dir="ltr">default</code> – The default thumbnail image. The default thumbnail for a video – or a resource that refers to a video, such as a playlist item or search result – is 120px wide and 90px tall. The default thumbnail for a channel is 88px wide and 88px tall.</li><li><code translate="no" dir="ltr">medium</code> – A higher resolution version of the thumbnail image. For a video (or a resource that refers to a video), this image is 320px wide and 180px tall. For a channel, this image is 240px wide and 240px tall.</li><li><code translate="no" dir="ltr">high</code> – A high resolution version of the thumbnail image. For a video (or a resource that refers to a video), this image is 480px wide and 360px tall. For a channel, this image is 800px wide and 800px tall.</li></ul></td> </tr> <tr id="snippet.thumbnails.(key).url"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.thumbnails.(key).</span>url</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The image's URL.</td> </tr> <tr id="snippet.thumbnails.(key).width"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.thumbnails.(key).</span>width</code></td> <td><code class="apitype notranslate" dir="ltr">unsigned integer</code><br> The image's width.</td> </tr> <tr id="snippet.thumbnails.(key).height"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.thumbnails.(key).</span>height</code></td> <td><code class="apitype notranslate" dir="ltr">unsigned integer</code><br> The image's height.</td> </tr> <tr id="snippet.scheduledStartTime"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>scheduledStartTime</code></td> <td><code class="apitype notranslate" dir="ltr">datetime</code><br> The date and time that the broadcast is scheduled to start. The value is specified in <a href="//web.archive.org/web/20211122121323/https://www.w3.org/TR/NOTE-datetime">ISO 8601</a> (<code translate="no" dir="ltr">YYYY-MM-DDThh:mm:ss.sZ</code>) format.</td> </tr> <tr id="snippet.scheduledEndTime"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>scheduledEndTime</code></td> <td><code class="apitype notranslate" dir="ltr">datetime</code><br> The date and time that the broadcast is scheduled to end. The value is specified in <a href="//web.archive.org/web/20211122121323/https://www.w3.org/TR/NOTE-datetime">ISO 8601</a> (<code translate="no" dir="ltr">YYYY-MM-DDThh:mm:ss.sZ</code>) format. If a <code translate="no" dir="ltr">liveBroadcast</code> resource does not specify a value for this property, then the broadcast is scheduled to continue indefinitely. Similarly, if you do not specify a value for this property, then YouTube treats the broadcast as if it will go on indefinitely.</td> </tr> <tr id="snippet.actualStartTime"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>actualStartTime</code></td> <td><code class="apitype notranslate" dir="ltr">datetime</code><br> The date and time that the broadcast actually started. This information is only available once the broadcast's state is <code translate="no" dir="ltr">live</code>. The value is specified in <a href="//web.archive.org/web/20211122121323/https://www.w3.org/TR/NOTE-datetime">ISO 8601</a> (<code translate="no" dir="ltr">YYYY-MM-DDThh:mm:ss.sZ</code>) format.</td> </tr> <tr id="snippet.actualEndTime"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>actualEndTime</code></td> <td><code class="apitype notranslate" dir="ltr">datetime</code><br> The date and time that the broadcast actually ended. This information is only available once the broadcast's state is <code translate="no" dir="ltr">complete</code>. The value is specified in <a href="//web.archive.org/web/20211122121323/https://www.w3.org/TR/NOTE-datetime">ISO 8601</a> (<code translate="no" dir="ltr">YYYY-MM-DDThh:mm:ss.sZ</code>) format.</td> </tr> <tr id="snippet.isDefaultBroadcast"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>isDefaultBroadcast</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> <div class="warning"> This property will be deprecated on or after September 1, 2020. At that time, YouTube will stop creating a default stream and default broadcast when a channel is enabled for live streaming. Please see the <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/revision_history#release_notes_04_16_2020">deprecation announcement</a> for more details. </div> This property indicates whether this broadcast is the default broadcast.<br><br> <b>How default broadcasts work</b><br><br>When a YouTube channel is enabled for live streaming, YouTube creates a default stream and a default broadcast for the channel. The stream defines how the channel owner sends live video to YouTube, and the broadcast is how viewers can see the default stream. A channel owner can use the <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams/list">liveStreams.list</a></code> and <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/list">liveBroadcasts.list</a></code> methods to identify these resources.<br><br>When a channel starts streaming video to its default stream, the video is visible on the channel's default broadcast. When the stream ends, YouTube converts the completed broadcast to a YouTube video and assigns the video a YouTube video ID.<br><br>After the conversion is complete, the video is included in the channel's list of uploaded videos. The video is not available immediately after the broadcast concludes, and the length of the delay is related to the actual length of the broadcast.</td> </tr> <tr id="snippet.liveChatId"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">snippet.</span>liveChatId</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The ID for the broadcast's YouTube live chat. With this ID, you can use the <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveChatMessages">liveChatMessage</a></code> resource's methods to retrieve, insert, or delete chat messages. You can also add or remove chat moderators, ban users from participating in live chats, or remove existing bans.</td> </tr> <tr id="status"> <td><code itemprop="property" translate="no" dir="ltr">status</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> The <code translate="no" dir="ltr">status</code> object contains information about the event's status.</td> </tr> <tr id="status.lifeCycleStatus"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">status.</span>lifeCycleStatus</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The broadcast's status. The status can be updated using the API's <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/transition">liveBroadcasts.transition</a></code> method.<br/><br/>Valid values for this property are: <ul> <li><code translate="no" dir="ltr">complete</code> – The broadcast is finished.</li> <li><code translate="no" dir="ltr">created</code> – The broadcast has incomplete settings, so it is not ready to transition to a <code translate="no" dir="ltr">live</code> or <code translate="no" dir="ltr">testing</code> status, but it has been created and is otherwise valid.</li> <li><code translate="no" dir="ltr">live</code> – The broadcast is active.</li> <li><code translate="no" dir="ltr">liveStarting</code> – The broadcast is in the process of transitioning to <code translate="no" dir="ltr">live</code> status.</li> <li><code translate="no" dir="ltr">ready</code> – The broadcast settings are complete and the broadcast can transition to a <code translate="no" dir="ltr">live</code> or <code translate="no" dir="ltr">testing</code> status.</li> <li><code translate="no" dir="ltr">revoked</code> – This broadcast was removed by an admin action.</li> <li><code translate="no" dir="ltr">testStarting</code> – The broadcast is in the process of transitioning to <code translate="no" dir="ltr">testing</code> status.</li> <li><code translate="no" dir="ltr">testing</code> – The broadcast is only visible to the partner.</li> </ul> </td> </tr> <tr id="status.privacyStatus"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">status.</span>privacyStatus</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The broadcast's privacy status. Note that the broadcast represents exactly one YouTube video, so the privacy settings are identical to those supported for videos. In addition, you can set this field by modifying the broadcast resource or by setting the <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/docs/videos#status.privacyStatus">privacyStatus</a></code> field of the corresponding video resource.<br/><br/>Valid values for this property are: <ul> <li><code translate="no" dir="ltr">private</code></li> <li><code translate="no" dir="ltr">public</code></li> <li><code translate="no" dir="ltr">unlisted</code></li> </ul> </td> </tr> <tr id="status.recordingStatus"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">status.</span>recordingStatus</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The broadcast's recording status.<br/><br/>Valid values for this property are: <ul> <li><code translate="no" dir="ltr">notRecording</code></li> <li><code translate="no" dir="ltr">recorded</code></li> <li><code translate="no" dir="ltr">recording</code></li> </ul> </td> </tr> <tr id="status.madeForKids"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">status.</span>madeForKids</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This value indicates whether the broadcast is designated as child-directed. This property value is read-only.</td> </tr> <tr id="status.selfDeclaredMadeForKids"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">status.</span>selfDeclaredMadeForKids</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> In a <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">liveBroadcasts.insert</a></code> request, this property allows the channel owner to designate the broadcast as being child-directed. In a <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/list">liveBroadcasts.list</a></code> request, the property value is only returned if the channel owner authorized the API request.</td> </tr> <tr id="contentDetails"> <td><code itemprop="property" translate="no" dir="ltr">contentDetails</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> The <code translate="no" dir="ltr">contentDetails</code> object contains information about the event's video content, such as whether the content can be shown in an embedded video player or if it will be archived and therefore available for viewing after the event has concluded.</td> </tr> <tr id="contentDetails.boundStreamId"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>boundStreamId</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> This value uniquely identifies the <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams">live stream</a></code> bound to the broadcast.</td> </tr> <tr id="contentDetails.boundStreamLastUpdateTimeMs"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>boundStreamLastUpdateTimeMs</code></td> <td><code class="apitype notranslate" dir="ltr">datetime</code><br> The date and time that the live stream referenced by <code translate="no" dir="ltr">boundStreamId</code> was last updated.</td> </tr> <tr id="contentDetails.monitorStream"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>monitorStream</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> The <code translate="no" dir="ltr">monitorStream</code> object contains information about the monitor stream, which the broadcaster can use to review the event content before the broadcast stream is shown publicly.</td> </tr> <tr id="contentDetails.monitorStream.enableMonitorStream"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.monitorStream.</span>enableMonitorStream</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This value determines whether the monitor stream is enabled for the broadcast. If the monitor stream is enabled, then YouTube will broadcast the event content on a special stream intended only for the broadcaster's consumption. The broadcaster can use the stream to review the event content and also to identify the optimal times to insert cuepoints.<br><br> You need to set this value to <code translate="no" dir="ltr">true</code> if you intend to have a <code translate="no" dir="ltr">testing</code> stage for your broadcast or if you want to have a broadcast delay for your event. In addition, if this property's value is <code translate="no" dir="ltr">true</code>, then you must transition your broadcast to the <code translate="no" dir="ltr">testing</code> state before you can transition it to the <code translate="no" dir="ltr">live</code> state. (If the property's value is <code translate="no" dir="ltr">false</code>, your broadcast cannot have a <code translate="no" dir="ltr">testing</code> stage, so you can transition the broadcast directly to the <code translate="no" dir="ltr">live</code> state.)<br><br> When you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update a broadcast</a></code>, this property must be set if your API request includes the <code translate="no" dir="ltr">contentDetails</code> part in the <code translate="no" dir="ltr">part</code> parameter value. However, when you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert a broadcast</a></code>, the property is optional and has a default value of <code translate="no" dir="ltr">true</code>.<br><br> <strong>Important:</strong> This property cannot be updated once the broadcast is in the <code translate="no" dir="ltr">testing</code> or <code translate="no" dir="ltr">live</code> state.</td> </tr> <tr id="contentDetails.monitorStream.broadcastStreamDelayMs"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.monitorStream.</span>broadcastStreamDelayMs</code></td> <td><code class="apitype notranslate" dir="ltr">unsigned integer</code><br> If you have set the <code translate="no" dir="ltr"><a href="#enableMonitorStream">enableMonitorStream</a></code> property to <code translate="no" dir="ltr">true</code>, then this property determines the length of the live broadcast delay.<br><br> When you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update a broadcast</a></code>, this property must be set if your API request includes the <code translate="no" dir="ltr">contentDetails</code> part in the <code translate="no" dir="ltr">part</code> parameter value. However, when you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert a broadcast</a></code>, the property is optional and has a default value of <code translate="no" dir="ltr">0</code>. This value indicates that the broadcast does not have a broadcast delay. <strong>Note:</strong> This property cannot be updated once the broadcast is in the <code translate="no" dir="ltr">testing</code> or <code translate="no" dir="ltr">live</code> state.</td> </tr> <tr id="contentDetails.monitorStream.embedHtml"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.monitorStream.</span>embedHtml</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> HTML code that embeds a player that plays the monitor stream.</td> </tr> <tr id="contentDetails.enableEmbed"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>enableEmbed</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This setting indicates whether the broadcast video can be played in an embedded player. If you choose to archive the video (using the <code translate="no" dir="ltr">enableArchive</code> property), this setting will also apply to the archived video.<br><br> When you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update a broadcast</a></code>, this property must be set if your API request includes the <code translate="no" dir="ltr">contentDetails</code> part in the <code translate="no" dir="ltr">part</code> parameter value. However, when you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert a broadcast</a></code>, the property is optional and has a default value of <code translate="no" dir="ltr">true</code>.<br><br> <strong>Note:</strong> This property cannot be updated once the broadcast is in the <code translate="no" dir="ltr">testing</code> or <code translate="no" dir="ltr">live</code> state.</td> </tr> <tr id="contentDetails.enableDvr"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>enableDvr</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This setting determines whether viewers can access DVR controls while watching the video. DVR controls enable the viewer to control the video playback experience by pausing, rewinding, or fast forwarding content. The default value for this property is <code translate="no" dir="ltr">true</code>. <br><br> When you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update a broadcast</a></code>, this property must be set if your API request includes the <code translate="no" dir="ltr">contentDetails</code> part in the <code translate="no" dir="ltr">part</code> parameter value. However, when you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert a broadcast</a></code>, the property is optional and has a default value of <code translate="no" dir="ltr">true</code>.<br><br> <strong>Important:</strong> You must set the value to <code translate="no" dir="ltr">true</code> and also set the <code translate="no" dir="ltr">enableArchive</code> property's value to <code translate="no" dir="ltr">true</code> if you want to make playback available immediately after the broadcast ends. In addition, this property cannot be updated once the broadcast is in the <code translate="no" dir="ltr">testing</code> or <code translate="no" dir="ltr">live</code> state.</td> </tr> <tr id="contentDetails.enableContentEncryption"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>enableContentEncryption</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This setting indicates whether YouTube should enable content encryption for the broadcast.<br><br> When you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update a broadcast</a></code>, this property must be set if your API request includes the <code translate="no" dir="ltr">contentDetails</code> part in the <code translate="no" dir="ltr">part</code> parameter value. However, when you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert a broadcast</a></code>, the property is optional and has a default value of <code translate="no" dir="ltr">false</code>.<br><br> <strong>Note:</strong> This property cannot be updated once the broadcast is in the <code translate="no" dir="ltr">testing</code> or <code translate="no" dir="ltr">live</code> state.</td> </tr> <tr id="contentDetails.startWithSlate"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>startWithSlate</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This setting indicates whether the broadcast should automatically begin with an <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/getting-started#Displaying_Slates">in-stream slate</a> when you update the broadcast's status to <code translate="no" dir="ltr">live</code>. After updating the status, you then need to send a <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveCuepoints/insert">liveCuepoints.insert</a></code> request that sets the cuepoint's <code translate="no" dir="ltr">eventState</code> to <code translate="no" dir="ltr">end</code> to remove the slate and make your broadcast stream visible to viewers. When you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update a broadcast</a></code>, this property must be set if your API request includes the <code translate="no" dir="ltr">contentDetails</code> part in the <code translate="no" dir="ltr">part</code> parameter value. However, when you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert a broadcast</a></code>, the property is optional and has a default value of <code translate="no" dir="ltr">false</code>.<br><br> <strong>Note:</strong> This property cannot be updated once the broadcast is in the <code translate="no" dir="ltr">testing</code> or <code translate="no" dir="ltr">live</code> state.</td> </tr> <tr id="contentDetails.recordFromStart"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>recordFromStart</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This setting indicates whether YouTube will automatically start recording the broadcast after the event's status changes to live.<br><br> This property's default value is <code translate="no" dir="ltr">true</code>, and it can only be set to <code translate="no" dir="ltr">false</code> if the broadcasting channel is allowed to disable recordings for live broadcasts.<br><br> If your channel does not have permission to disable recordings, and you attempt to insert a broadcast with the <code translate="no" dir="ltr">recordFromStart</code> property set to <code translate="no" dir="ltr">false</code>, the API will return a <code translate="no" dir="ltr">Forbidden</code> error. In addition, if your channel does not have that permission and you attempt to update a broadcast to set the <code translate="no" dir="ltr">recordFromStart</code> property to <code translate="no" dir="ltr">false</code>, the API will return a <code translate="no" dir="ltr">modificationNotAllowed</code> error.<br><br> When you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/update">update a broadcast</a></code>, this property must be set if your API request includes the <code translate="no" dir="ltr">contentDetails</code> part in the <code translate="no" dir="ltr">part</code> parameter value. However, when you <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveBroadcasts/insert">insert a broadcast</a></code>, the property is optional and has a default value of <code translate="no" dir="ltr">true</code>.<br><br> <strong>Important:</strong> You must also set the <code translate="no" dir="ltr">enableDvr</code> property's value to <code translate="no" dir="ltr">true</code> if you want the playback to be available immediately after the broadcast ends. If you set this property's value to <code translate="no" dir="ltr">true</code> but do not also set the <code translate="no" dir="ltr">enableDvr</code> property to <code translate="no" dir="ltr">true</code>, there may be a delay of around one day before the archived video will be available for playback.<br><br> <strong>Note:</strong> This property cannot be updated once the broadcast is in the <code translate="no" dir="ltr">testing</code> or <code translate="no" dir="ltr">live</code> state.</td> </tr> <tr id="contentDetails.enableClosedCaptions"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>enableClosedCaptions</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> This property has been deprecated as of December 17, 2015. Use the <code translate="no" dir="ltr"><a href="#contentDetails.closedCaptionsType">contentDetails.closedCaptionsType</a></code> property instead.<br><br>This setting indicates whether HTTP POST closed captioning is enabled for this broadcast. For API clients that are already using this property:<ul><li>Setting the property value to <code translate="no" dir="ltr">true</code> is equivalent to setting the <code translate="no" dir="ltr">contentDetails.closedCaptionsType</code> property to <code translate="no" dir="ltr">closedCaptionsHttpPost</code>.</li><li>Setting the property value to <code translate="no" dir="ltr">false</code> is equivalent to setting the <code translate="no" dir="ltr">contentDetails.closedCaptionsType</code> property to <code translate="no" dir="ltr">closedCaptionsDisabled</code>.</td> </tr> <tr id="contentDetails.closedCaptionsType"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>closedCaptionsType</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> <b>Note: This property <em>replaces</em> the <code translate="no" dir="ltr">contentDetails.enableClosedCaptions</code> property.</b><br><br>This property indicates whether closed captioning is enabled for your broadcast and, if so, what type of closed captions you are providing:<ul><li><code translate="no" dir="ltr">closedCaptionsDisabled</code>: Closed captions are disabled for the live broadcast.</li><li><code translate="no" dir="ltr">closedCaptionsHttpPost</code>: You will send captions, via HTTP POST, to an <a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams#contentDetails.closedCaptionsIngestionUrl">ingestion URL</a> associated with your live stream.</li><li><code translate="no" dir="ltr">closedCaptionsEmbedded</code>: Captions will be encoded in the video stream using EIA-608 and/or CEA-708 formats.</li></ul> </td> </tr> <tr id="contentDetails.projection"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>projection</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> The projection format of this broadcast. The property's default value is <code translate="no" dir="ltr">rectangular</code>.<br/><br/>Valid values for this property are: <ul> <li><code translate="no" dir="ltr">360</code></li> <li><code translate="no" dir="ltr">rectangular</code></li> </ul> </td> </tr> <tr id="contentDetails.enableLowLatency"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>enableLowLatency</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> Indicates whether this broadcast should be encoded for low-latency streaming. A low-latency stream can reduce the amount of time it takes for video to be visible to users watching a broadcast, though it can also impact the resolution for viewers of the stream.</td> </tr> <tr id="contentDetails.latencyPreference"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>latencyPreference</code></td> <td><code class="apitype notranslate" dir="ltr">string</code><br> Indicates which latency setting to use for this broadcast. This property may be used instead of <code translate="no" dir="ltr">enableLowLatency</code>, which does not support <code translate="no" dir="ltr">ultraLow</code>.<br><br>A low-latency stream can reduce the amount of time it takes for video to be visible to users watching a broadcast, though it can also affect the smoothness of playback.<br><br>An ultra-low-latency stream further reduces the time it takes for video to be visible to viewers, making interaction with viewers easier, but ultra-low latency does not support closed captions, or resolutions higher than 1080p.<br/><br/>Valid values for this property are: <ul> <li><code translate="no" dir="ltr">normal</code></li> <li><code translate="no" dir="ltr">low</code></li> <li><code translate="no" dir="ltr">ultraLow</code></li> </ul> </td> </tr> <tr id="contentDetails.enableAutoStart"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>enableAutoStart</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> Indicates whether this broadcast should start automatically when you start streaming video on the bound <code translate="no" dir="ltr"><a href="/web/20211122121323/https://developers.google.com/youtube/v3/live/docs/liveStreams">live stream</a></code>.</td> </tr> <tr id="contentDetails.enableAutoStop"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">contentDetails.</span>enableAutoStop</code></td> <td><code class="apitype notranslate" dir="ltr">boolean</code><br> Indicates whether this broadcast should stop automatically around one minute after the channel owner stops streaming video on the bound video stream.</td> </tr> <tr id="statistics"> <td><code itemprop="property" translate="no" dir="ltr">statistics</code></td> <td><code class="apitype notranslate" dir="ltr">object</code><br> The <code translate="no" dir="ltr">statistics</code> object contains statistics related to a live broadcast. The values for these statistics can change during the broadcast and can only be retrieved while the broadcast is live.</td> </tr> <tr id="statistics.totalChatCount"> <td><code itemprop="property" translate="no" dir="ltr"><span class="quiet">statistics.</span>totalChatCount</code></td> <td><code class="apitype notranslate" dir="ltr">unsigned long</code><br> The total number of live chat messages associated with the broadcast. The property and its value are present if the broadcast is visible to the user, has the live chat feature enabled, and has at least one message. Note that this property will not specify a value after the broadcast ends. So, this property would not identify the number of chat messages for an archived video of a completed live broadcast.</td> </tr> </tbody> </table> </section> </div> </div> <devsite-recommendations display="in-page" hidden yield> </devsite-recommendations> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-recommendations id="recommendations-link" yield></devsite-recommendations> </article> <devsite-content-footer class="nocontent"> <p>Except as otherwise noted, the content of this page is licensed under the <a href="https://web.archive.org/web/20211122121323/https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://web.archive.org/web/20211122121323/https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates.</p> <p>Last updated 2020-09-21 UTC.</p> </devsite-content-footer> <div class="devsite-content-data"> <template class="devsite-thumb-rating-down-categories"> [{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples / code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] </template> <template class="devsite-thumb-rating-up-categories"> [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> <nav class="devsite-footer-promos nocontent" aria-label="Promotions"> <ul class="devsite-footer-promos-list"> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20211122121323/http://apiblog.youtube.com/" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 1)"> <img class="devsite-footer-promo-icon" src="https://web.archive.org/web/20211122121323im_/https://www.gstatic.com/images/icons/material/product/2x/blogger_64dp.png" loading="lazy" alt="Blog"> Blog </a> <div class="devsite-footer-promo-description">The latest news on the YouTube API blog</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20211122121323/https://github.com/youtube/api-samples" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 2)"> <img class="devsite-footer-promo-icon" src="/web/20211122121323im_/https://developers.google.com/site-assets/logo-github.svg" loading="lazy" alt="GitHub"> GitHub </a> <div class="devsite-footer-promo-description">Find API code samples and other YouTube open-source projects.</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20211122121323/https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 3)"> <img class="devsite-footer-promo-icon" src="/web/20211122121323im_/https://developers.google.com/site-assets/developers_64dp.png" loading="lazy" alt="Issue Tracker"> Issue Tracker </a> <div class="devsite-footer-promo-description">Something wrong? Send us a bug report!</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20211122121323/http://stackoverflow.com/questions/ask?tags=youtube-livestreaming-api" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 4)"> <img class="devsite-footer-promo-icon" src="/web/20211122121323im_/https://developers.google.com/site-assets/logo-stack-overflow.svg" loading="lazy" alt="Stack Overflow"> Stack Overflow </a> <div class="devsite-footer-promo-description">Ask a question under the youtube-api tag</div> </li> <li class="devsite-footer-promo"> <a href="https://web.archive.org/web/20211122121323/https://www.youtube.com/user/YouTubeDev" class="devsite-footer-promo-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Promo Link (index 5)"> <img class="devsite-footer-promo-icon" src="/web/20211122121323im_/https://developers.google.com/site-assets/logo-youtube.svg" loading="lazy" alt="Videos"> Videos </a> <div class="devsite-footer-promo-description">Check out the YouTube Developer Relations team's YouTube channel</div> </li> </ul> </nav> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Tools</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20211122121323/https://script.google.com/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)"> Script Editor </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20211122121323/https://script.google.com/dashboard" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)"> Service Health Dashboard </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Issue Tracker</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20211122121323/https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)"> File a bug </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20211122121323/https://issuetracker.google.com/issues/new?component=186600&template=874803" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)"> Request a feature </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://web.archive.org/web/20211122121323/https://issuetracker.google.com/issues?q=componentid:186600" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)"> See open issues </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Product Info</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/terms" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)"> Terms of Service </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/branding_guidelines" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)"> Branding Guidelines </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/creating_monetizable_applications" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)"> Monetization Guidelines </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/web/20211122121323/https://developers.google.com/youtube/youtube-api-list" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)"> APIs subject to Deprecation Policy </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://web.archive.org/web/20211122121323/https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <img class="devsite-footer-sites-logo" src="https://web.archive.org/web/20211122121323im_/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/lockup-developers.svg" loading="lazy" alt="Google Developers"> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20211122121323/https://developer.android.com/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link"> Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20211122121323/https://developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link"> Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20211122121323/https://firebase.google.com/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link"> Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//web.archive.org/web/20211122121323/https://cloud.google.com/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link"> Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="/web/20211122121323/https://developers.google.com/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link"> All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/web/20211122121323/https://developers.google.com/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link"> Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//web.archive.org/web/20211122121323/https://policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link"> Privacy </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> <span class="devsite-footer-utility-description">Sign up for the Google Developers newsletter</span> <a class="devsite-footer-utility-link gc-analytics-event" href="//web.archive.org/web/20211122121323/https://services.google.com/fb/forms/googledevelopersnewsletter/?utm_medium=referral&utm_source=google-products&utm_team=googledevs&utm_campaign=201611-newsletter-launch" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link"> Subscribe </a> </li> </ul> <devsite-language-selector> <devsite-select class="devsite-language-selector-menu"> <select aria-label="Select your language preference." class="devsite-language-selector-select" name="language" track-name="click" track-type="languageSelector"> <option>Language</option> <option value="en" lang="en"> English </option> <option value="id" lang="id"> Bahasa Indonesia </option> <option value="de" lang="de"> Deutsch </option> <option value="es" lang="es"> Español </option> <option value="fr" lang="fr"> Français </option> <option value="pt_br" lang="pt_br"> Português – Brasil </option> <option value="ru" lang="ru"> Русский </option> <option value="zh_cn" lang="zh_cn"> 中文 – 简体 </option> <option value="ja" lang="ja"> 日本語 </option> <option value="ko" lang="ko"> 한국어 </option> </select> </devsite-select> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar> </devsite-snackbar> <devsite-tooltip></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics enable-analytics-iframe> <script type="application/json" analytics>[{"gaid": "UA-24532603-1", "dimensions": {"dimension3": false, "dimension6": "en", "dimension1": "Signed out", "dimension4": "YouTube Live Streaming API", "dimension5": "en", "dimension11": false}, "metrics": {"ratings_value": "metric1", "ratings_count": "metric2"}}]</script> <script type="application/json" gtm>{"parameters": {"freeTrialEligibleUser": "False", "internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "reference", "projectName": "YouTube Live Streaming API", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="9T7vioFy6DLZp8F6c3+EedumbPhfZq"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://web.archive.org/web/20211122121323/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://web.archive.org/web/20211122121323/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959","https://web.archive.org/web/20211122121323/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers","https://web.archive.org/web/20211122121323/https://developers-dot-devsite-v2-prod.appspot.com",null,null,["/_pwa/developers/manifest.json","https://web.archive.org/web/20211122121323/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/images/video-placeholder.svg","https://web.archive.org/web/20211122121323/https://www.gstatic.com/devrel-devsite/prod/v83c28b42a9d2de845cf6ea5b33e8c3314f0e1ea60229353829f7578993509959/developers/images/favicon.png","https://web.archive.org/web/20211122121323/https://fonts.googleapis.com/css?family=Google+Sans_old:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,40,45,50,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,111,112,113,115,117,118,120,122,123,124,125,126,127,128,129,130,131,132,133,134,135,136,138,141,142,144,147,148,149,150,151,152,153,154,157,159,161,164,165],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o\n"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

LiveBroadcasts | YouTube Live Streaming API | Google Developers