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

संसाधन का प्रतिनिधित्व

यह 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
इस संसाधन का एटैग.
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 की वैल्यू UNIX टाइम ज़ीरो के हिसाब से होती है. साथ ही, इस वैल्यू को एपीआई या YouTube 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: कैप्शन, वीडियो स्ट्रीम में EIA-608 और/या CEA-708 फ़ॉर्मैट का इस्तेमाल करके कोड में बदले जाएंगे.
contentDetails.projection string
इस ब्रॉडकास्ट का प्रोजेक्शन फ़ॉर्मैट. प्रॉपर्टी की डिफ़ॉल्ट वैल्यू rectangular है.

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

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

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

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