Groups: update

किसी ग्रुप के मेटाडेटा में बदलाव करता है. फ़िलहाल, ग्रुप के टाइटल को ही अपडेट किया जा सकता है. (ग्रुप आइटम जोड़ने और हटाने के लिए, groupItems.insert और groupItems.delete का इस्तेमाल करें.)

अनुरोध

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

PUT 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 फ़ील्ड की वैल्यू अपडेट हो जाती है.

  • id
  • snippet.title

जवाब

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

गड़बड़ियां

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

इसे आज़माएं!

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