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
इस संसाधन का ऐट.
items[] list
ग्रुप में शामिल आइटम की सूची. सूची का हर आइटम एक groupItem संसाधन है.

गड़बड़ियां

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

इसे आज़माएं!

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