LiveCuepoints

liveCuepoint रिसॉर्स और liveCuepoints.insert तरीके को रोक दिया गया है और उन्हें liveBroadcasts.cuepoint तरीके से बदल दिया गया है.

liveCuepoint का एक रिसॉर्स, ब्रॉडकास्ट वीडियो स्ट्रीम में एक क्यूपॉइंट डालता है, जिससे विज्ञापन के लिए ब्रेक ट्रिगर हो सकता है.

ध्यान दें: यह एपीआई निर्देश, YouTube Content ID API का हिस्सा है और इसके लिए, liveBroadcast और liveStream संसाधनों को मैनेज करने के अनुरोध से अलग अनुमति चाहिए.

तरीके

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

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

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

JSON के इस फ़ॉर्मैट में liveCuepoints संसाधन का फ़ॉर्मैट दिखता है:

{
  "id": string,
  "kind": "youtubePartner#liveCuepoint",
  "broadcastId": string,
  "settings": {
    "offsetTimeMs": long,
    "walltime": datetime,
    "cueType": string,
    "durationSecs": unsigned integer
  }
}

प्रॉपर्टी

इस टेबल में उन प्रॉपर्टी के बारे में बताया गया है जो इस रिसॉर्स में मौजूद हैं:

प्रॉपर्टी
id string
यह एक ऐसी वैल्यू है जो YouTube, खास तौर पर पहचान करने के लिए असाइन करता है.
kind string
एपीआई संसाधन का टाइप. liveCuepoint रिसॉर्स की वैल्यू youtubePartner#liveCuepoint है.
broadcastId string
वह आईडी जो YouTube उस ब्रॉडकास्ट को खास तौर पर पहचानने के लिए असाइन करता है जिसमें क्यूपॉइंट डाला जाता है.
settings object
settings ऑब्जेक्ट, क्यूपॉइंट की सेटिंग के बारे में बताता है.
settings.offsetTimeMs long
इस वैल्यू से वीडियो के उस समय की जानकारी मिलती है जब दर्शकों को कोई विज्ञापन या इन-स्ट्रीम स्लेट देखना चाहिए. प्रॉपर्टी की वैल्यू, मॉनिटर स्ट्रीम की शुरुआत से टाइम ऑफ़सेट की पहचान करती है. यह मिलीसेकंड में तय होता है. यह मान मिलीसेकंड में मापा जाता है. हालांकि, वैल्यू असल में एक अनुमान होती है. YouTube उस समय के आस-पास की चीज़ों को और सटीक बनाता है. अगर आपके ब्रॉडकास्ट में मॉनिटर स्ट्रीम नहीं है, तो आपको इस पैरामीटर की वैल्यू नहीं देनी चाहिए.

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

ध्यान दें: अगर आपके ब्रॉडकास्ट का कोई टेस्ट चरण था, तो ऑफ़सेट को टेस्ट फ़ेज़ शुरू होने के समय से मापा जाता है.
settings.walltime datetime
यह वैल्यू, दीवार पर लगने वाले समय के बारे में बताती है, जब क्यूपॉइंट डालना होता है. वैल्यू ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ) फ़ॉर्मैट में होती है.

अगर अनुरोध में कोई क्यूपॉइंट डालने की कोशिश की जाती है, तो इस प्रॉपर्टी में और settings.offsetTimeMs प्रॉपर्टी के लिए वैल्यू तय करने पर, एपीआई गड़बड़ी दिखाता है.
settings.cueType string
क्यूपॉइंट का टाइप. अलग-अलग तरह के क्यूपाइंट के बारे में जानने के लिए, शुरू करना गाइड देखें. साथ ही, अपने ब्रॉडकास्ट के दौरान क्यूपॉइंट डालने के सबसे सही तरीकों के लिए, ब्रॉडकास्ट की लाइफ़ दस्तावेज़ देखें.

इस प्रॉपर्टी की मान्य वैल्यू ये हैं:
  • ad
settings.durationSecs unsigned integer
क्यूपॉइंट का कुल समय, सेकंड में. अगर cueType ad है और इसे अनदेखा किया जाता है, तो यह मान तय किया जाना चाहिए.