Groups: list

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

अनुरोध करें

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

GET 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 के ग्रुप और ग्रुप आइटम को मैनेज करते हैं.

पैरामीटर

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

पैरामीटर
फ़िल्टर (इनमें से किसी एक पैरामीटर के बारे में बताएं)
id string
id पैरामीटर फिर से हासिल किए जा रहे संसाधनों के लिए YouTube ग्रुप आईडी की कॉमा-सेपरेटेड लिस्ट बनाता है. हर ग्रुप, पुष्टि किए गए उपयोगकर्ता का होना चाहिए. group के संसाधन में, id प्रॉपर्टी से समूह के YouTube समूह आईडी का पता चलता है.

ध्यान दें कि अगर आप id पैरामीटर में कोई मान नहीं डालते हैं, तो आपको mine पैरामीटर true पर सेट करना होगा.
mine boolean
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. पुष्टि किए गए उपयोगकर्ता के मालिकाना हक वाले सभी ग्रुप को फिर से पाने के लिए, इस पैरामीटर की वैल्यू को true पर सेट करें.
ज़रूरी पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ सही तरीके से की गई अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर खास तौर पर YouTube के उन कॉन्टेंट पार्टनर के लिए है जिनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक है और उन्हें मैनेज करने का अधिकार है.

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

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

इस तरीके को कॉल करते समय, अनुरोध का मुख्य हिस्सा न दें.

जवाब

अगर अनुरोध कामयाब रहता है, तो इस रिस्पॉन्स के साथ रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:

{
  "kind": "youtube#groupListResponse",
  "etag": etag,
  "items": [
    group Resource
  ],
  "nextPageToken": string
}

प्रॉपर्टी

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

प्रॉपर्टी
kind string
इससे यह पता चलता है कि एपीआई संसाधन किस तरह का है. वैल्यू youtube#groupListResponse होगी.
etag etag
इस संसाधन का ऐट.
items[] list
ऐसे ग्रुप की सूची जो एपीआई अनुरोध के पैरामीटर से मेल खाते हैं. सूची का हर आइटम एक group संसाधन है.
nextPageToken string
यह टोकन, pageTokenसेट की वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इससे नतीजों के सेट में, अगला पेज फिर से मिल जाता है.

गड़बड़ियां

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

इसे आज़माएं!

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