LiveBroadcasts

एपीआई अब आपके लाइव स्ट्रीम को "बच्चों के लिए बना" के तौर पर मार्क करने की सुविधा देता है. साथ ही, liveBroadcast रिसॉर्स में अब एक ऐसी प्रॉपर्टी है जो उस लाइव स्ट्रीम के "बच्चों के लिए बना" स्टेटस की पहचान करती है. YouTube API की सेवाओं की शर्तें और डेवलपर के लिए नीतियां भी 10 जनवरी, 2020 को अपडेट की गई थीं. ज़्यादा जानकारी के लिए, YouTube Live Streaming API सेवा और YouTube API की सेवाओं की शर्तों में हुए बदलावों का इतिहास देखें.

liveBroadcast संसाधन, किसी ऐसे इवेंट के बारे में बताता है जिसे YouTube पर लाइव वीडियो का इस्तेमाल करके स्ट्रीम किया जाएगा.

तरीके

एपीआई, liveBroadcasts संसाधनों के लिए इन तरीकों का इस्तेमाल करता है:

list
एपीआई अनुरोध पैरामीटर से मैच करने वाले YouTube ब्रॉडकास्ट की सूची दिखाता है. इसे अभी आज़माएं.
शामिल करें
ब्रॉडकास्ट बनाता है. इसे अभी आज़माएं.
अपडेट करें
ब्रॉडकास्ट को अपडेट करता है. उदाहरण के लिए, liveBroadcast रिसॉर्स के contentDetails ऑब्जेक्ट में तय की गई ब्रॉडकास्ट सेटिंग में बदलाव किया जा सकता है. इसे अभी आज़माएं.
मिटाएं
किसी ब्रॉडकास्ट को मिटाता है. इसे अभी आज़माएं.
बाइंड करें
YouTube ब्रॉडकास्ट को किसी स्ट्रीम से जोड़ता है या ब्रॉडकास्ट और स्ट्रीम के बीच मौजूदा बाइंडिंग को हटाता है. किसी ब्रॉडकास्ट को सिर्फ़ एक वीडियो स्ट्रीम से जोड़ा जा सकता है. हालांकि, एक वीडियो स्ट्रीम को एक से ज़्यादा ब्रॉडकास्ट से जोड़ा जा सकता है. इसे अभी आज़माएं.
ट्रांज़िशन
YouTube लाइव ब्रॉडकास्ट का स्टेटस बदलता है और नए स्टेटस से जुड़ी प्रोसेस शुरू करता है. उदाहरण के लिए, जब किसी ब्रॉडकास्ट का स्टेटस testing पर सेट किया जाता है, तो YouTube उस ब्रॉडकास्ट की मॉनिटर स्ट्रीम पर वीडियो ट्रांसमिट करना शुरू कर देता है. इस तरीके को कॉल करने से पहले, आपको यह पुष्टि करनी चाहिए कि आपके ब्रॉडकास्ट से जुड़ी स्ट्रीम के लिए, status.streamStatus प्रॉपर्टी की वैल्यू active है. इसे अभी आज़माएं.
cuepoint
लाइव ब्रॉडकास्ट में क्यू पॉइंट डालता है. क्यूपॉइंट से विज्ञापन के लिए ब्रेक ट्रिगर हो सकता है.

संसाधन का रेप्रज़ेंटेशन

यहां दिया गया JSON स्ट्रक्चर, liveBroadcasts संसाधन का फ़ॉर्मैट दिखाता है:

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

प्रॉपर्टी

इस टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
एपीआई संसाधन के टाइप की पहचान करता है. वैल्यू youtube#liveBroadcast होगी.
etag etag
इस संसाधन का Etag.
id string
यह वह आईडी होता है जिसे YouTube, ब्रॉडकास्ट की खास पहचान करने के लिए असाइन करता है.
snippet object
snippet ऑब्जेक्ट में इवेंट की बुनियादी जानकारी होती है. इसमें इवेंट का टाइटल, ब्यौरा, शुरू होने का समय, और खत्म होने का समय शामिल होता है.
snippet.publishedAt datetime
वह तारीख और समय जब ब्रॉडकास्ट को YouTube के लाइव ब्रॉडकास्ट शेड्यूल में जोड़ा गया था. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में दिया गया है.
snippet.channelId string
यह एक आईडी है. इसका इस्तेमाल YouTube, ब्रॉडकास्ट पब्लिश करने वाले चैनल की खास ढंग से पहचान करने के लिए करता है.
snippet.title string
ब्रॉडकास्ट का टाइटल. ध्यान दें कि ब्रॉडकास्ट में सिर्फ़ एक YouTube वीडियो दिखता है. ब्रॉडकास्ट रिसोर्स में बदलाव करके या उससे जुड़े वीडियो रिसोर्स के title फ़ील्ड को सेट करके, इस फ़ील्ड को सेट किया जा सकता है.
snippet.description string
ब्रॉडकास्ट की जानकारी. title की तरह ही, इस फ़ील्ड को सेट करने के लिए, ब्रॉडकास्ट रिसॉर्स में बदलाव करें या उससे जुड़े वीडियो रिसॉर्स के description फ़ील्ड को सेट करें.
snippet.thumbnails object
ब्रॉडकास्ट से जुड़ी थंबनेल इमेज का मैप. इस ऑब्जेक्ट में नेस्ट किए गए हर ऑब्जेक्ट के लिए, कुंजी थंबनेल इमेज का नाम होती है और वैल्यू एक ऐसा ऑब्जेक्ट होता है जिसमें थंबनेल के बारे में अन्य जानकारी होती है.
snippet.thumbnails.(key) object
मान्य कुंजी वैल्यू ये हैं:
  • default – थंबनेल की डिफ़ॉल्ट इमेज. किसी वीडियो या वीडियो से जुड़े संसाधन (जैसे, प्लेलिस्ट आइटम या खोज नतीजा) का डिफ़ॉल्ट थंबनेल 120 पिक्सल चौड़ा और 90 पिक्सल ऊंचा होता है. चैनल के लिए डिफ़ॉल्ट थंबनेल 88 पिक्सल चौड़ा और 88 पिक्सल लंबा होता है.
  • medium – थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन. वीडियो (या वीडियो का रेफ़रंस देने वाले संसाधन) के लिए, यह इमेज 320 पिक्सल चौड़ी और 180 पिक्सल ऊंची होनी चाहिए. चैनल के लिए, यह इमेज 240 पिक्सल चौड़ी और 240 पिक्सल ऊंची होनी चाहिए.
  • high – थंबनेल इमेज का हाई रिज़ॉल्यूशन वाला वर्शन. किसी वीडियो (या वीडियो का रेफ़रंस देने वाले संसाधन) के लिए, यह इमेज 480 पिक्सल चौड़ी और 360 पिक्सल ऊंची होनी चाहिए. किसी चैनल के लिए, यह इमेज 800 पिक्सल चौड़ी और 800 पिक्सल ऊंची होनी चाहिए.
snippet.thumbnails.(key).url string
इमेज का यूआरएल.
snippet.thumbnails.(key).width unsigned integer
इमेज की चौड़ाई.
snippet.thumbnails.(key).height unsigned integer
इमेज की ऊंचाई.
snippet.scheduledStartTime datetime
ब्रॉडकास्ट शुरू होने की तारीख और समय. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में दिया गया है. Creator Studio में, ब्रॉडकास्ट शुरू होने का समय शेड्यूल किए बिना भी ब्रॉडकास्ट बनाया जा सकता है. इस मामले में, चैनल का मालिक जब भी स्ट्रीमिंग शुरू करता है, तब ब्रॉडकास्ट शुरू हो जाता है. इन ब्रॉडकास्ट के लिए, datetime वैल्यू, यूनिक्स के ज़रिए टाइमस्टैंप को 0 पर सेट करने के लिए इस्तेमाल की जाती है. इस वैल्यू को एपीआई या Creator Studio का इस्तेमाल करके नहीं बदला जा सकता.
snippet.scheduledEndTime datetime
ब्रॉडकास्ट खत्म होने की तारीख और समय. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में दिया गया है. अगर किसी liveBroadcast रिसॉर्स में इस प्रॉपर्टी के लिए कोई वैल्यू नहीं दी गई है, तो ब्रॉडकास्ट को अनलिमिटेड तौर पर चलने के लिए शेड्यूल किया जाता है. इसी तरह, अगर आपने इस प्रॉपर्टी के लिए कोई वैल्यू नहीं दी है, तो YouTube इस ब्रॉडकास्ट को ऐसे दिखाता है जैसे वह हमेशा चलेगा.
snippet.actualStartTime datetime
ब्रॉडकास्ट शुरू होने की तारीख और समय. यह जानकारी सिर्फ़ तब उपलब्ध होती है, जब ब्रॉडकास्ट की स्थिति live हो. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में दिया गया है.
snippet.actualEndTime datetime
ब्रॉडकास्ट खत्म होने की तारीख और समय. यह जानकारी सिर्फ़ तब उपलब्ध होती है, जब ब्रॉडकास्ट की स्थिति complete हो. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में दिया गया है.
snippet.isDefaultBroadcast boolean
इस प्रॉपर्टी का इस्तेमाल 1 सितंबर, 2020 या इसके बाद नहीं किया जा सकेगा. इसके बाद, जब चैनल पर लाइव स्ट्रीम करने की सुविधा चालू होगी, तब YouTube डिफ़ॉल्ट स्ट्रीम और डिफ़ॉल्ट ब्रॉडकास्ट बनाना बंद कर देगा. ज़्यादा जानकारी के लिए, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना देखें.
इस प्रॉपर्टी से पता चलता है कि यह ब्रॉडकास्ट, डिफ़ॉल्ट ब्रॉडकास्ट है या नहीं.

डिफ़ॉल्ट ब्रॉडकास्ट कैसे काम करते हैं

जब किसी YouTube चैनल पर लाइव स्ट्रीमिंग की सुविधा चालू होती है, तो YouTube उस चैनल के लिए एक डिफ़ॉल्ट स्ट्रीम और एक डिफ़ॉल्ट ब्रॉडकास्ट बनाता है. स्ट्रीम से यह तय होता है कि चैनल का मालिक, YouTube पर लाइव वीडियो कैसे भेजता है. वहीं, ब्रॉडकास्ट से यह तय होता है कि दर्शक डिफ़ॉल्ट स्ट्रीम कैसे देख सकते हैं. चैनल का मालिक, liveStreams.list और liveBroadcasts.list तरीकों का इस्तेमाल करके इन संसाधनों की पहचान कर सकता है.

जब कोई चैनल अपनी डिफ़ॉल्ट स्ट्रीम पर वीडियो स्ट्रीम करना शुरू करता है, तो वह वीडियो चैनल के डिफ़ॉल्ट ब्रॉडकास्ट पर दिखता है. स्ट्रीम खत्म होने के बाद, YouTube उस ब्रॉडकास्ट को YouTube वीडियो में बदल देता है और उसे एक YouTube वीडियो आईडी असाइन करता है.

वीडियो को बदलने के बाद, उसे चैनल पर अपलोड किए गए वीडियो की सूची में शामिल कर दिया जाता है. ब्रॉडकास्ट खत्म होने के तुरंत बाद वीडियो उपलब्ध नहीं होता. वीडियो उपलब्ध होने में लगने वाला समय, ब्रॉडकास्ट की कुल अवधि पर निर्भर करता है.
snippet.liveChatId string
ब्रॉडकास्ट की YouTube लाइव चैट का आईडी. इस आईडी की मदद से, चैट मैसेज वापस पाने, डालने या मिटाने के लिए, liveChatMessage रिसॉर्स के तरीकों का इस्तेमाल किया जा सकता है. आपके पास चैट मॉडरेटर जोड़ने या हटाने का विकल्प भी होता है. साथ ही, लाइव चैट में हिस्सा लेने से उपयोगकर्ताओं को प्रतिबंधित किया जा सकता है या मौजूदा प्रतिबंध हटाए जा सकते हैं.
status object
status ऑब्जेक्ट में, इवेंट की स्थिति की जानकारी होती है.
status.lifeCycleStatus string
ब्रॉडकास्ट की स्थिति. एपीआई के liveBroadcasts.transition तरीके का इस्तेमाल करके, स्थिति को अपडेट किया जा सकता है.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • complete – ब्रॉडकास्ट खत्म हो गया है.
  • created – ब्रॉडकास्ट की सेटिंग पूरी नहीं हैं. इसलिए, इसे live या testing स्टेटस पर ट्रांज़िशन नहीं किया जा सकता. हालांकि, इसे बनाया जा चुका है और यह मान्य है.
  • live – ब्रॉडकास्ट चालू है.
  • liveStarting – ब्रॉडकास्ट का स्टेटस live पर ट्रांज़िशन हो रहा है.
  • ready – ब्रॉडकास्ट की सेटिंग पूरी हो गई हैं और ब्रॉडकास्ट का स्टेटस live या testing पर ट्रांज़िशन हो सकता है.
  • revoked – एडमिन ने इस ब्रॉडकास्ट को हटा दिया है.
  • testStarting – ब्रॉडकास्ट का स्टेटस testing पर ट्रांज़िशन हो रहा है.
  • testing – ब्रॉडकास्ट सिर्फ़ पार्टनर को दिखता है.
status.privacyStatus string
ब्रॉडकास्ट की निजता की स्थिति. ध्यान दें कि ब्रॉडकास्ट में सिर्फ़ एक YouTube वीडियो दिखता है. इसलिए, निजता सेटिंग भी वीडियो की तरह ही होती हैं. इसके अलावा, ब्रॉडकास्ट रिसॉर्स में बदलाव करके या उससे जुड़े वीडियो रिसॉर्स के privacyStatus फ़ील्ड को सेट करके, इस फ़ील्ड को सेट किया जा सकता है.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • private
  • public
  • unlisted
status.recordingStatus string
ब्रॉडकास्ट की रिकॉर्डिंग की स्थिति.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • notRecording
  • recorded
  • recording
status.madeForKids boolean
इस वैल्यू से पता चलता है कि ब्रॉडकास्ट को बच्चों के लिए बनाया गया है या नहीं. इस प्रॉपर्टी की वैल्यू सिर्फ़ पढ़ने के लिए है.
status.selfDeclaredMadeForKids boolean
इस प्रॉपर्टी की मदद से, चैनल के मालिक को liveBroadcasts.insert अनुरोध करने पर, ब्रॉडकास्ट को 'बच्चों के लिए' के तौर पर मार्क करने की अनुमति मिलती है. liveBroadcasts.list के अनुरोध में, प्रॉपर्टी की वैल्यू सिर्फ़ तब दिखती है, जब चैनल के मालिक ने एपीआई के अनुरोध को अनुमति दी हो.
contentDetails object
contentDetails ऑब्जेक्ट में, इवेंट के वीडियो कॉन्टेंट के बारे में जानकारी होती है. जैसे, कॉन्टेंट को एम्बेड किए गए वीडियो प्लेयर में दिखाया जा सकता है या नहीं या उसे संग्रहित किया जाएगा और इसलिए इवेंट खत्म होने के बाद उसे देखने के लिए उपलब्ध कराया जाएगा.
contentDetails.boundStreamId string
इस वैल्यू से, ब्रॉडकास्ट से जुड़े live stream की खास तौर पर पहचान की जाती है.
contentDetails.boundStreamLastUpdateTimeMs datetime
वह तारीख और समय जब boundStreamId से रेफ़र की गई लाइव स्ट्रीम को आखिरी बार अपडेट किया गया था.
contentDetails.monitorStream object
monitorStream ऑब्जेक्ट में मॉनिटर स्ट्रीम की जानकारी होती है. ब्रॉडकास्टर इसका इस्तेमाल, ब्रॉडकास्ट स्ट्रीम को सार्वजनिक तौर पर दिखाने से पहले, इवेंट के कॉन्टेंट की समीक्षा करने के लिए कर सकता है.
contentDetails.monitorStream.enableMonitorStream boolean
इस वैल्यू से यह तय होता है कि ब्रॉडकास्ट के लिए मॉनिटर स्ट्रीम चालू है या नहीं. अगर मॉनिटर स्ट्रीम की सुविधा चालू है, तो YouTube इवेंट का कॉन्टेंट एक खास स्ट्रीम पर ब्रॉडकास्ट करेगा. यह स्ट्रीम सिर्फ़ ब्रॉडकास्टर के लिए होती है. ब्रॉडकास्टर, इवेंट के कॉन्टेंट की समीक्षा करने के लिए स्ट्रीम का इस्तेमाल कर सकता है. साथ ही, वह क्यूपॉइंट डालने के लिए सबसे सही समय की पहचान भी कर सकता है.

अगर आपको अपने ब्रॉडकास्ट के लिए testing स्टेज चाहिए या आपको अपने इवेंट के लिए ब्रॉडकास्ट में देरी चाहिए, तो आपको इस वैल्यू को true पर सेट करना होगा. इसके अलावा, अगर इस प्रॉपर्टी की वैल्यू true है, तो आपको अपने ब्रॉडकास्ट को live स्टेटस पर ट्रांज़िशन करने से पहले, उसे testing स्टेटस पर ट्रांज़िशन करना होगा. (अगर प्रॉपर्टी की वैल्यू false है, तो आपके ब्रॉडकास्ट में testing स्टेज नहीं हो सकती. इसलिए, ब्रॉडकास्ट को सीधे live स्टेटस पर ट्रांज़िशन किया जा सकता है.)

update a broadcast का इस्तेमाल करने पर, यह प्रॉपर्टी सेट होनी चाहिए. ऐसा तब ज़रूरी है, जब आपके एपीआई अनुरोध में part पैरामीटर की वैल्यू में contentDetails हिस्सा शामिल हो. हालांकि, insert a broadcast का इस्तेमाल करने पर, प्रॉपर्टी की वैल्यू देना ज़रूरी नहीं है. इसकी डिफ़ॉल्ट वैल्यू true होती है.

अहम जानकारी: ब्रॉडकास्ट के testing या live स्टेटस में होने के बाद, इस प्रॉपर्टी को अपडेट नहीं किया जा सकता.
contentDetails.monitorStream.broadcastStreamDelayMs unsigned integer
अगर आपने enableMonitorStream प्रॉपर्टी को true पर सेट किया है, तो यह प्रॉपर्टी लाइव ब्रॉडकास्ट में होने वाली देरी की अवधि तय करती है.

update a broadcast का इस्तेमाल करने पर, यह प्रॉपर्टी सेट होनी चाहिए. ऐसा तब ज़रूरी है, जब आपके एपीआई अनुरोध में part पैरामीटर की वैल्यू में contentDetails हिस्सा शामिल हो. हालांकि, insert a broadcast का इस्तेमाल करने पर, प्रॉपर्टी की वैल्यू देना ज़रूरी नहीं है. इसकी डिफ़ॉल्ट वैल्यू 0 होती है. इस वैल्यू से पता चलता है कि ब्रॉडकास्ट में देरी नहीं है. ध्यान दें: ब्रॉडकास्ट के testing या live स्टेटस में होने के बाद, इस प्रॉपर्टी को अपडेट नहीं किया जा सकता.
contentDetails.monitorStream.embedHtml string
एचटीएमएल कोड, जो मॉनिटर स्ट्रीम चलाने वाले प्लेयर को एम्बेड करता है.
contentDetails.enableEmbed boolean
इस सेटिंग से पता चलता है कि ब्रॉडकास्ट वीडियो को एम्बेड किए गए प्लेयर में चलाया जा सकता है या नहीं. अगर आपने enableArchive प्रॉपर्टी का इस्तेमाल करके वीडियो को संग्रहित करने का विकल्प चुना है, तो यह सेटिंग संग्रहित किए गए वीडियो पर भी लागू होगी.

update a broadcast का इस्तेमाल करने पर, यह प्रॉपर्टी सेट होनी चाहिए. ऐसा तब ज़रूरी है, जब आपके एपीआई अनुरोध में part पैरामीटर की वैल्यू में contentDetails हिस्सा शामिल हो. हालांकि, insert a broadcast का इस्तेमाल करने पर, प्रॉपर्टी की वैल्यू देना ज़रूरी नहीं है. इसकी डिफ़ॉल्ट वैल्यू true होती है.

ध्यान दें: ब्रॉडकास्ट के testing या live स्टेटस में होने के बाद, इस प्रॉपर्टी को अपडेट नहीं किया जा सकता.
contentDetails.enableDvr boolean
इस सेटिंग से यह तय होता है कि दर्शक वीडियो देखते समय, डीवीआर के कंट्रोल ऐक्सेस कर सकते हैं या नहीं. डीवीआर कंट्रोल की मदद से, दर्शक वीडियो को रोककर, रिवाइंड करके या तेज़ी से आगे बढ़ाकर, वीडियो चलाने के अनुभव को कंट्रोल कर सकते हैं. इस प्रॉपर्टी की डिफ़ॉल्ट वैल्यू true है.

update a broadcast का इस्तेमाल करने पर, यह प्रॉपर्टी सेट होनी चाहिए. ऐसा तब ज़रूरी है, जब आपके एपीआई अनुरोध में part पैरामीटर की वैल्यू में contentDetails हिस्सा शामिल हो. हालांकि, insert a broadcast का इस्तेमाल करने पर, प्रॉपर्टी की वैल्यू देना ज़रूरी नहीं है. इसकी डिफ़ॉल्ट वैल्यू true होती है.

अहम जानकारी: अगर आपको ब्रॉडकास्ट खत्म होने के तुरंत बाद वीडियो चलाने की सुविधा उपलब्ध करनी है, तो आपको इस एट्रिब्यूट की वैल्यू true पर सेट करनी होगी. साथ ही, enableArchive प्रॉपर्टी की वैल्यू भी true पर सेट करनी होगी. इसके अलावा, ब्रॉडकास्ट के testing या live स्टेटस में होने के बाद, इस प्रॉपर्टी को अपडेट नहीं किया जा सकता.
contentDetails.recordFromStart boolean
इस सेटिंग से पता चलता है कि इवेंट का स्टेटस 'लाइव' में बदलने के बाद, YouTube ब्रॉडकास्ट को अपने-आप रिकॉर्ड करेगा या नहीं.

इस प्रॉपर्टी की डिफ़ॉल्ट वैल्यू true है. इसे सिर्फ़ तब false पर सेट किया जा सकता है, जब ब्रॉडकास्ट करने वाले चैनल को लाइव ब्रॉडकास्ट के लिए रिकॉर्डिंग बंद करने की अनुमति हो.

अगर आपके चैनल के पास रिकॉर्डिंग बंद करने की अनुमति नहीं है और आपने recordFromStart प्रॉपर्टी को false पर सेट करके ब्रॉडकास्ट डालने की कोशिश की है, तो एपीआई Forbidden गड़बड़ी दिखाएगा. इसके अलावा, अगर आपके चैनल के पास यह अनुमति नहीं है और आपने recordFromStart प्रॉपर्टी को false पर सेट करने के लिए ब्रॉडकास्ट को अपडेट करने की कोशिश की, तो एपीआई modificationNotAllowed गड़बड़ी का मैसेज दिखाएगा.

update a broadcast का इस्तेमाल करने पर, यह प्रॉपर्टी सेट होनी चाहिए. ऐसा तब ज़रूरी है, जब आपके एपीआई अनुरोध में part पैरामीटर की वैल्यू में contentDetails हिस्सा शामिल हो. हालांकि, insert a broadcast का इस्तेमाल करने पर, प्रॉपर्टी की वैल्यू देना ज़रूरी नहीं है. इसकी डिफ़ॉल्ट वैल्यू true होती है.

अहम जानकारी: अगर आपको ब्रॉडकास्ट खत्म होने के तुरंत बाद वीडियो चलाने की सुविधा देनी है, तो आपको enableDvr प्रॉपर्टी की वैल्यू को true पर सेट करना होगा. अगर इस प्रॉपर्टी की वैल्यू को true पर सेट किया जाता है, लेकिन enableDvr प्रॉपर्टी को true पर सेट नहीं किया जाता है, तो हो सकता है कि संग्रहित किया गया वीडियो, चलाने के लिए एक दिन बाद उपलब्ध हो.

ध्यान दें: ब्रॉडकास्ट के testing या live स्टेटस में होने के बाद, इस प्रॉपर्टी को अपडेट नहीं किया जा सकता.
contentDetails.enableClosedCaptions boolean
इस प्रॉपर्टी का इस्तेमाल 17 दिसंबर, 2015 से नहीं किया जा सकता. इसके बजाय, contentDetails.closedCaptionsType प्रॉपर्टी का इस्तेमाल करें.

इस सेटिंग से पता चलता है कि इस ब्रॉडकास्ट के लिए, एचटीटीपी पोस्ट की मदद से सबटाइटल दिखाने की सुविधा चालू है या नहीं. इस प्रॉपर्टी का इस्तेमाल पहले से कर रहे API क्लाइंट के लिए:
  • प्रॉपर्टी की वैल्यू को true पर सेट करना, contentDetails.closedCaptionsType प्रॉपर्टी को closedCaptionsHttpPost पर सेट करने के बराबर है.
  • प्रॉपर्टी की वैल्यू को false पर सेट करना, contentDetails.closedCaptionsType प्रॉपर्टी को closedCaptionsDisabled पर सेट करने के बराबर है.
contentDetails.closedCaptionsType string
ध्यान दें: यह प्रॉपर्टी, contentDetails.enableClosedCaptions प्रॉपर्टी की जगह ले लेती है.

इस प्रॉपर्टी से पता चलता है कि आपके ब्रॉडकास्ट के लिए सबटाइटल की सुविधा चालू है या नहीं. अगर चालू है, तो किस तरह के सबटाइटल उपलब्ध कराए जा रहे हैं:
  • closedCaptionsDisabled: लाइव स्ट्रीम के लिए सबटाइटल की सुविधा बंद है.
  • closedCaptionsHttpPost: आपको एचटीटीपी पोस्ट का इस्तेमाल करके, अपनी लाइव स्ट्रीम से जुड़े इनजेशन यूआरएल पर कैप्शन भेजने होंगे.
  • closedCaptionsEmbedded: कैप्शन को EIA-608 और/या CEA-708 फ़ॉर्मैट का इस्तेमाल करके, वीडियो स्ट्रीम में एन्कोड किया जाएगा.
contentDetails.projection string
इस ब्रॉडकास्ट का प्रोजेक्शन फ़ॉर्मैट. प्रॉपर्टी की डिफ़ॉल्ट वैल्यू rectangular है.

इस प्रॉपर्टी के लिए मान्य वैल्यू ये हैं:
  • 360
  • rectangular
contentDetails.enableLowLatency boolean
इससे पता चलता है कि इस ब्रॉडकास्ट को कम इंतज़ार वाली स्ट्रीमिंग के लिए एन्कोड किया जाना चाहिए या नहीं. कम लेटेंसी वाली स्ट्रीम से, ब्रॉडकास्ट देखने वाले लोगों को वीडियो दिखने में लगने वाला समय कम हो सकता है. हालांकि, इससे स्ट्रीम देखने वाले लोगों के रिज़ॉल्यूशन पर भी असर पड़ सकता है.
contentDetails.latencyPreference string
इससे पता चलता है कि इस ब्रॉडकास्ट के लिए, लैटेंसी की किस सेटिंग का इस्तेमाल करना है. इस प्रॉपर्टी का इस्तेमाल enableLowLatency के बजाय किया जा सकता है, जो ultraLow के साथ काम नहीं करती.

कम लेटेंसी वाली स्ट्रीम से, दर्शकों को वीडियो दिखने में लगने वाला समय कम हो सकता है. हालांकि, इससे वीडियो चलाने में आने वाली समस्याओं पर भी असर पड़ सकता है.

बहुत कम लेटेंसी वाली स्ट्रीम से, दर्शकों को वीडियो दिखने में लगने वाला समय और भी कम हो सकता है. इससे दर्शकों के साथ इंटरैक्ट करना आसान हो जाता है. हालांकि, बहुत कम लेटेंसी वाली स्ट्रीम में सबटाइटल या 1080 पिक्सल से ज़्यादा रिज़ॉल्यूशन का इस्तेमाल नहीं किया जा सकता.

इस प्रॉपर्टी की मान्य वैल्यू ये हैं:
  • normal
  • low
  • ultraLow
contentDetails.enableAutoStart boolean
इससे पता चलता है कि live stream से स्ट्रीमिंग शुरू करने पर, यह ब्रॉडकास्ट अपने-आप शुरू होना चाहिए या नहीं.
contentDetails.enableAutoStop boolean
इससे पता चलता है कि चैनल के मालिक के, बाउंड की गई वीडियो स्ट्रीम पर वीडियो स्ट्रीमिंग बंद करने के करीब एक मिनट बाद, यह ब्रॉडकास्ट अपने-आप बंद होना चाहिए या नहीं.
statistics object
statistics ऑब्जेक्ट में, लाइव ब्रॉडकास्ट से जुड़े आंकड़े होते हैं. ब्रॉडकास्ट के दौरान, इन आंकड़ों की वैल्यू बदल सकती हैं. साथ ही, इन्हें सिर्फ़ लाइव ब्रॉडकास्ट के दौरान ही देखा जा सकता है.
statistics.totalChatCount unsigned long
ब्रॉडकास्ट से जुड़े लाइव चैट मैसेज की कुल संख्या. प्रॉपर्टी और उसकी वैल्यू तब मौजूद होती है, जब उपयोगकर्ता को ब्रॉडकास्ट दिख रहा हो, लाइव चैट की सुविधा चालू हो, और कम से कम एक मैसेज हो. ध्यान दें कि ब्रॉडकास्ट खत्म होने के बाद, इस प्रॉपर्टी में कोई वैल्यू नहीं दिखेगी. इसलिए, यह प्रॉपर्टी, खत्म हो चुके लाइव ब्रॉडकास्ट के संग्रहित वीडियो के लिए, चैट मैसेज की संख्या की पहचान नहीं करेगी.
monetizationDetails object
monetizationDetails ऑब्जेक्ट में, स्ट्रीम से कमाई करने की जानकारी होती है. जैसे, विज्ञापन अपने-आप चलने की सुविधा चालू है या नहीं या लाइव स्ट्रीम के बीच में विज्ञापन दिखाने में देरी हुई है या नहीं.
monetizationDetails.cuepointSchedule object
cuepointSchedule ऑब्जेक्ट, ब्रॉडकास्ट के लिए विज्ञापन ऑटोमेशन सेटिंग तय करता है.
monetizationDetails.cuepointSchedule.enabled boolean
इस वैल्यू से यह तय होता है कि ब्रॉडकास्ट में विज्ञापन अपने-आप डाले जाएंगे या नहीं. अगर वैल्यू true है, तो YouTube ब्रॉडकास्ट में अपने-आप मिडरोल विज्ञापन डाल देगा. विज्ञापन दिखाने का शेड्यूल, monetizationDetails.cuepointSchedule ऑब्जेक्ट के अन्य फ़ील्ड की वैल्यू से तय होगा.
monetizationDetails.cuepointSchedule.pauseAdsUntil datetime
इस वैल्यू से पता चलता है कि YouTube को तय की गई तारीख और समय तक, ब्रॉडकास्ट में बीच में विज्ञापन नहीं दिखाने चाहिए. वैल्यू को ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) फ़ॉर्मैट में दिया गया है. विज्ञापनों को रोकने के लिए, वैल्यू को आने वाले समय की तारीख और समय पर सेट किया जाना चाहिए. समय बीत जाने पर, विज्ञापनों को फिर से दिखाने के लिए, फ़ील्ड की वैल्यू को आने वाले समय की तारीख और समय पर भी सेट किया जा सकता है.
monetizationDetails.cuepointSchedule.scheduleStrategy string
इस वैल्यू से पता चलता है कि YouTube को क्यू पॉइंट शेड्यूल करने के लिए किस रणनीति का इस्तेमाल करना चाहिए. मान्य वैल्यू ये हैं:
  • CONCURRENT: सभी दर्शकों के लिए, क्यू पॉइंट एक ही समय पर शेड्यूल किए जाते हैं
  • NON_CONCURRENT: अलग-अलग दर्शकों के लिए, क्यू पॉइंट अलग-अलग समय पर शेड्यूल किए जाते हैं. इस तरीके से, विज्ञापनों को ज़्यादा दर से दिखाया जा सकता है. इससे दर्शकों को ज़रूरी शर्तें पूरी करने पर, क्यूपॉइंट मिल सकते हैं.
monetizationDetails.cuepointSchedule.repeatIntervalSecs unsigned integer
इस वैल्यू से पता चलता है कि ब्रॉडकास्ट के दौरान, विज्ञापन अपने-आप दिखने के बीच का इंटरवल, सेकंड में कितना है. उदाहरण के लिए, अगर वैल्यू 300 है, तो YouTube पांच मिनट के इंटरवल पर, लाइव स्ट्रीम के बीच में दिखने वाले विज्ञापन के क्यूपॉइंट डाल सकता है.

ध्यान दें कि इस वैल्यू से, एक के बाद एक क्यू पॉइंट के शुरू होने के बीच का समय पता चलता है. इसका मतलब है कि इंटरवल को एक क्यूपॉइंट के आखिर से लेकर अगले क्यूपॉइंट की शुरुआत तक नहीं मापा जाता.