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 का इस्तेमाल करें.