इस पेज का अनुवाद Cloud Translation API से किया गया है.

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` ऑब्जेक्ट में, स्ट्रीम से कमाई करने की जानकारी होती है. जैसे, विज्ञापन अपने-आप चलने की सुविधा चालू है या नहीं या लाइव स्ट्रीम के बीच में विज्ञापन दिखाने में देरी हुई है या नहीं. अहम जानकारी: किसी वीडियो के लिए अपने-आप विज्ञापन दिखाने की सुविधा चालू करने के लिए, चैनल के पास वीडियो से कमाई करने की अनुमति होनी चाहिए. ब्रॉडकास्ट की कमाई करने की सेटिंग, जैसे कि कमाई करने की सुविधा या विज्ञापन अपने-आप चलने की सुविधा (जैसे, "YouTube को आपके लिए लाइव स्ट्रीम के बीच में विज्ञापन दिखाने की अनुमति दें" या "लाइव स्ट्रीम के बीच में दिखने वाले विज्ञापनों को तय फ़्रीक्वेंसी पर शेड्यूल करें") को YouTube Studio में जाकर सेट किया जा सकता है. ऐसा ब्रॉडकास्ट बनाते समय या लाइव स्ट्रीम के दौरान ब्रॉडकास्ट में बदलाव करते समय किया जा सकता है.
`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 पांच मिनट के इंटरवल पर, लाइव स्ट्रीम के बीच में दिखने वाले विज्ञापन के क्यूपॉइंट डाल सकता है. ध्यान दें कि इस वैल्यू से, एक के बाद एक क्यू पॉइंट के शुरू होने के बीच का समय पता चलता है. इसका मतलब है कि इंटरवल को एक क्यूपॉइंट के आखिर से लेकर अगले क्यूपॉइंट की शुरुआत तक नहीं मापा जाता.

LiveBroadcasts संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

तरीके

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

प्रॉपर्टी

LiveBroadcasts