Groups: insert

यह YouTube Analytics ग्रुप बनाता है. ग्रुप बनाने के बाद, उसमें आइटम जोड़ने के लिए groupItems.insert तरीके का इस्तेमाल करें.

अनुरोध

एचटीटीपी अनुरोध

POST https://youtubeanalytics.googleapis.com/v2/groups

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत है (पुष्टि और अनुमति के बारे में ज़्यादा पढ़ें).

स्कोप
https://www.googleapis.com/auth/yt-analytics.readonly अपने YouTube कॉन्टेंट के लिए YouTube Analytics की रिपोर्ट देखें. इस स्कोप से, उपयोगकर्ता गतिविधि की मेट्रिक का ऐक्सेस मिलता है. जैसे, व्यू की संख्या और रेटिंग की संख्या.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly अपने YouTube कॉन्टेंट के लिए YouTube Analytics की कमाई से जुड़ी रिपोर्ट देखें. इस स्कोप में, उपयोगकर्ता गतिविधि की मेट्रिक के साथ-साथ, अनुमानित रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस की मेट्रिक का ऐक्सेस मिलता है.
https://www.googleapis.com/auth/youtube अपना YouTube खाता मैनेज करें. चैनल के मालिक, YouTube Analytics API में इस दायरे का इस्तेमाल, YouTube Analytics ग्रुप और ग्रुप आइटम को मैनेज करने के लिए करते हैं.
https://www.googleapis.com/auth/youtubepartner YouTube पर YouTube ऐसेट और उससे जुड़ा कॉन्टेंट देखें और मैनेज करें. YouTube Analytics API में, कॉन्टेंट के मालिक इस स्कोप का इस्तेमाल करके, YouTube Analytics के ग्रुप और ग्रुप आइटम मैनेज करते हैं.

पैरामीटर

नीचे दी गई टेबल में उन पैरामीटर की सूची दी गई है जिनका इस्तेमाल इस क्वेरी में किया जा सकता है. सूची में दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी नहीं पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर सिर्फ़ उन YouTube कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक है और जिन्हें उन्हें मैनेज करने की अनुमति है.

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

अनुरोध का मुख्य भाग

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

  • snippet.title
  • contentDetails.itemType

जवाब

अगर यह तरीका कामयाब होता है, तो यह जवाब के मुख्य हिस्से में ग्रुप रिसॉर्स दिखाता है.

गड़बड़ियां

एपीआई में, गड़बड़ी के ऐसे मैसेज नहीं होते जो इस एपीआई के तरीके के लिए खास हों. हालांकि, इस तरीके से भी गड़बड़ी के मैसेज के दस्तावेज़ में दी गई, एपीआई से जुड़ी सामान्य गड़बड़ियां दिख सकती हैं.

इसे आज़माएं!

इस एपीआई को कॉल करने के लिए, APIs Explorer का इस्तेमाल करें. साथ ही, एपीआई का अनुरोध और रिस्पॉन्स देखें.