GroupItems: list

अहम जानकारी: इस तरीके से एपीआई अनुरोध करने के लिए, इनमें से किसी एक का ऐक्सेस होना ज़रूरी है:
  • https://www.googleapis.com/auth/youtube दायरा
    या
  • https://www.googleapis.com/auth/youtube.readonly स्कोप
    और
    https://www.googleapis.com/auth/yt-analytics.readonly स्कोप

पहले विकल्प में एक स्कोप का इस्तेमाल किया जाता है, जो रीड-राइट स्कोप होता है. वहीं, दूसरे विकल्प में दो रीड-ओनली स्कोप का इस्तेमाल किया जाता है.

एपीआई अनुरोध पैरामीटर से मैच करने वाले ग्रुप आइटम का कलेक्शन दिखाता है.

अनुरोध

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

GET https://youtubeanalytics.googleapis.com/v2/groupItems

अनुमति देना

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

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

पैरामीटर

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

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

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

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

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

जवाब

अगर एपीआई सही से जुड़ जाता है, तो यह तरीका इस स्ट्रक्चर के साथ रिस्पॉन्स बॉडी दिखाता है:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

प्रॉपर्टी

नीचे दी गई टेबल में, इस संसाधन में मौजूद प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
kind string
एपीआई संसाधन के टाइप की पहचान करता है. वैल्यू youtube#groupItemListResponse होगी.
etag etag
इस संसाधन का Etag.
items[] list
ग्रुप में मौजूद आइटम की सूची. सूची का हर आइटम, groupItem संसाधन के बारे में बताता है.

गड़बड़ियां

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

इसे आज़माएं!

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