ध्यान दें: YouTube Content ID API का इस्तेमाल, YouTube कॉन्टेंट पार्टनर करते हैं. इसे सभी डेवलपर या YouTube का इस्तेमाल करने वाले सभी लोग ऐक्सेस नहीं कर सकते. अगर आपको Google API कंसोल में दी गई सेवाओं में से एक सेवा के तौर पर YouTube Content ID API नहीं दिख रहा है, तो YouTube Partner Program के बारे में ज़्यादा जानने के लिए YouTube सहायता केंद्र पर जाएं.
YouTube के अधिकारों को मैनेज करने वाले सिस्टम में मौजूद हर ऑब्जेक्ट, कॉन्टेंट के मालिक से जुड़ा होता है. कॉन्टेंट का मालिक, एक YouTube पार्टनर होता है. इसके पास, ऐसेट के कलेक्शन का अधिकार होता है. जब कोई ऐप्लिकेशन YouTube Content ID API का इस्तेमाल करता है, तो उसके पास एसेट, नीतियों, और दावों के लिए कॉन्टेंट के मालिक की अनुमति होनी चाहिए. जब ऐप्लिकेशन के पुष्टि किए गए उपयोगकर्ता के पास कॉन्टेंट के मालिक वाले खाते का ऐक्सेस होता है, तब उसे यह अनुमति मिलती है. अगर पुष्टि किए गए उपयोगकर्ता के पास कॉन्टेंट के मालिक के खाते का ऐक्सेस नहीं है, तो Content ID API को कॉल नहीं किया जा सकेगा.
कॉन्टेंट के मालिक का आईडी वापस पाना
कॉन्टेंट के मालिक का आईडी पाने के लिए, YouTube Content ID API के contentOwners.list
तरीके का इस्तेमाल करें. एपीआई के रिस्पॉन्स में, उस उपयोगकर्ता से जुड़े contentOwner
संसाधनों की सूची होती है जिसने अनुरोध करने की अनुमति दी थी. हर संसाधन में, id
प्रॉपर्टी कॉन्टेंट के मालिक का आईडी बताती है.
कॉन्टेंट के मालिक का आईडी, प्रोग्राम के हिसाब से अपने-आप फ़ेच हो जाता है या नहीं, यह जानने के लिए, वीडियो अपलोड करना और उस पर दावा करना लेख पढ़ें.
कॉन्टेंट के मालिक की ओर से YouTube API को कॉल करना
YouTube Content ID एपीआई
ज़्यादातर उपयोगकर्ता, कॉन्टेंट के मालिक के एक ही खाते को ऐक्सेस कर सकते हैं. इसलिए, Content ID API का इस्तेमाल करके, यह पता लगाया जा सकता है कि कॉन्टेंट का मालिक किस खाते से काम कर रहा है. इसलिए, Content ID API कॉल के लिए onBehalfOfContentOwner
पैरामीटर का इस्तेमाल करना ज़रूरी नहीं है.
हालांकि, कुछ उपयोगकर्ताओं के पास कॉन्टेंट के मालिक के कई खातों का ऐक्सेस होता है. इन उपयोगकर्ताओं के हर एपीआई अनुरोध में onBehalfOfContentOwner
पैरामीटर शामिल होना चाहिए, ताकि यह साफ़ तौर पर पता चल सके कि कॉन्टेंट के मालिक के किस खाते का इस्तेमाल करना है.
YouTube डेटा एपीआई (v3)
YouTube Data API के कई तरीके, onBehalfOfContentOwner
पैरामीटर के साथ भी काम करते हैं. उस पैरामीटर का इस्तेमाल करने वाले तरीकों में डेलिगेशन लागू होता है. इससे ऐप्लिकेशन, कॉन्टेंट के मालिक के मैनेज किए जाने वाले चैनलों, मैनेज किए जा रहे उन चैनलों के वीडियो या दूसरे एपीआई संसाधनों पर कार्रवाइयां कर सकता है.
YouTube Data API में डेलिगेशन की सुविधा इस्तेमाल करते समय, onBehalfOfContentOwner
पैरामीटर हमेशा ज़रूरी होता है. पैरामीटर की वैल्यू एक आईडी है, जिससे कॉन्टेंट के मालिक की खास पहचान होती है. YouTube Content ID API के contentOwners.list
तरीके का इस्तेमाल करके, प्रोग्राम के हिसाब से आईडी को वापस पाया जा सकता है.
कुछ एपीआई कॉल के लिए, एक अन्य डेलिगेशन पैरामीटर की ज़रूरत भी होती है. नीचे दी गई सूची में दो उदाहरण दिए गए हैं:
- जब उपयोगकर्ता कॉन्टेंट के मालिक के तौर पर किसी चैनल पर कोई कार्रवाई करता है, तब
videos.insert()
तरीके के लिएonBehalfOfContentOwner
औरonBehalfOfContentOwnerChannel
पैरामीटर सेट करना ज़रूरी है. नया वीडियो उस चैनल पर अपलोड होता है जिसके लिए,onBehalfOfContentOwnerChannel
पैरामीटर की वैल्यू तय की जाती है. search.list()
तरीके के लिए,onBehalfOfContentOwner
औरforContentOwner
पैरामीटर सेट करना ज़रूरी है. इस मामले में,forContentOwner
पैरामीटर की मदद से उपयोगकर्ता, एपीआई को यह निर्देश दे सकता है कि वह कॉन्टेंट के मालिक के मालिकाना हक वाले ऐसे संसाधन ही दिखाएं जिन्हेंonBehalfOfContentOwner
पैरामीटर ने तय किया है.
हर खास तरीके से जुड़ी जानकारी देने वाला दस्तावेज़, जब डेलिगेशन की सुविधा काम करती हो और आपको onBehalfOfContentOwner
के अलावा एक और पैरामीटर सेट करने की ज़रूरत हो या नहीं.
YouTube Analytics API
YouTube Analytics API का इस्तेमाल करके कॉन्टेंट के मालिक की रिपोर्ट पाने के लिए, आपको एपीआई अनुरोध में ids
पैरामीटर की वैल्यू contentOwner==OWNER_ID
पर सेट करनी होती है. इसमें OWNER_ID
, कॉन्टेंट के मालिक का आईडी बताता है.