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 वैल्यू, यूनिक्स टाइम ज़ीरो से मेल खाती है. इस वैल्यू को एपीआई या 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 प्रॉपर्टी का इस्तेमाल करें.

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

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

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

वीडियो स्ट्रीम होने और उसके दिखने के समय का अंतर कम होने से, ब्रॉडकास्ट देखने वाले लोगों को वीडियो दिखने में लगने वाले समय को कम किया जा सकता है. हालांकि, इससे वीडियो बिना किसी रुकावट के चल सकता है.

वीडियो स्ट्रीम होने और उसके दिखने के समय का अंतर कम होने से, दर्शकों को वीडियो दिखने में लगने वाला समय कम हो जाता है. हालांकि, इस तरह के रिज़ॉल्यूशन की वजह से, दर्शकों के साथ बातचीत करने में ज़्यादा समय लगता है.1

  • 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 पांच मिनट के इंटरवल पर, वीडियो के बीच में दिखने वाले विज्ञापन के क्यूपॉइंट डाल सकता है.

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