API Reference

YouTube Analytics API की मदद से, YouTube चैनल या कॉन्टेंट के मालिक के लिए YouTube Analytics का डेटा फिर से पाया जा सकता है. एपीआई, रीयल-टाइम क्वेरी के साथ काम करता है और एपीआई अनुरोध के पैरामीटर के आधार पर रिपोर्ट जनरेट करता है.

एपीआई दो तरह के फ़ंक्शन का इस्तेमाल करता है:

  • रिपोर्ट वापस पाना - एपीआई का reports.query तरीका, YouTube Analytics रिपोर्ट को फिर से हासिल करता है.

  • YouTube Analytics ग्रुप मैनेजमेंट – YouTube Analytics ग्रुप, ज़्यादा से ज़्यादा 500 चैनलों, वीडियो, प्लेलिस्ट या एसेट का कस्टम कलेक्शन है. इस एपीआई का इस्तेमाल करके, YouTube Analytics ग्रुप बनाने, उन्हें वापस पाने, और अपडेट करने के कई तरीके काम करते हैं. चैनल और कॉन्टेंट के मालिक, ग्रुप के सभी आइटम के लिए एग्रीगेट किया गया डेटा वापस पाने के लिए, reports.query तरीके का इस्तेमाल कर सकते हैं. इससे, परफ़ॉर्मेंस का विश्लेषण करने में मदद मिलती है.

इस पेज पर, एपीआई के संसाधनों और उन तरीकों की खास जानकारी दी गई है जिनसे ये फ़ंक्शन चालू होते हैं.

अनुमति दें

YouTube Analytics API से आने वाले सभी अनुरोध स्वीकार किए जाने चाहिए. अनुमति देने वाली गाइड में OAuth 2.0 प्रोटोकॉल को इस्तेमाल करने का तरीका बताया गया है. इससे, आपको पुष्टि करने वाले टोकन वापस पाने में मदद मिलेगी.

YouTube Analytics API अनुरोधों को अनुमति देने के लिए, यहां दिए गए तरीकों का इस्तेमाल करें:

बंदूक पर लगने वाली दूरबीन
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 के ग्रुप और ग्रुप आइटम को मैनेज करते हैं.

कॉन्टेंट वापस पाने की रिपोर्ट करें

एपीआई के reports.query तरीके से, कई अलग-अलग YouTube Analytics रिपोर्ट पाई जा सकती हैं. हर अनुरोध में किसी चैनल आईडी या कॉन्टेंट के मालिक, शुरू होने की तारीख, खत्म होने की तारीख, और कम से कम एक मेट्रिक बताने के लिए क्वेरी पैरामीटर का इस्तेमाल किया जाता है. डाइमेंशन, फ़िल्टर, और क्रम से लगाने के निर्देश जैसे अतिरिक्त क्वेरी पैरामीटर भी दिए जा सकते हैं.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://youtubeanalytics.googleapis.com/v2 से जुड़े यूआरआई
query GET /reports YouTube Analytics रिपोर्ट फिर से हासिल करता है. हर एपीआई अनुरोध में, चैनल आईडी या कॉन्टेंट के मालिक, शुरू होने की तारीख, खत्म होने की तारीख, और कम से कम एक मेट्रिक बताने के लिए, क्वेरी पैरामीटर का इस्तेमाल होता है. डाइमेंशन, फ़िल्टर या क्रम से लगाने के निर्देश जैसे अतिरिक्त क्वेरी पैरामीटर भी दिए जा सकते हैं.
  • मेट्रिक, उपयोगकर्ता की गतिविधि का अलग-अलग मेज़रमेंट होती हैं. जैसे, वीडियो व्यू या रेटिंग (पसंद और नापसंद).
  • डाइमेंशन सामान्य मानदंड होते हैं, जिनका इस्तेमाल डेटा इकट्ठा करने के लिए किया जाता है, जैसे कि किस तारीख को उपयोगकर्ता गतिविधि हुई या वह देश जहां उपयोगकर्ता मौजूद थे. रिपोर्ट में, डेटा की हर लाइन में डाइमेंशन वैल्यू का यूनीक कॉम्बिनेशन होता है.
  • फ़िल्टर, डाइमेंशन की ऐसी वैल्यू होते हैं जिनसे वापस मिलने वाले डेटा के बारे में पता चलता है. उदाहरण के लिए, किसी खास देश, किसी खास वीडियो या वीडियो ग्रुप के लिए डेटा वापस लाया जा सकता है.
चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट से जुड़ी सूचियों से यह तय होता है कि मेट्रिक, डाइमेंशन, और फ़िल्टर में कौनसे कॉम्बिनेशन दिखेंगे.

समूह प्रबंधन

इस एपीआई से, YouTube Analytics ग्रुप बनाने और मैनेज करने के लिए दो रिसॉर्स मिलते हैं:

ग्रुप

group संसाधन, YouTube Analytics ग्रुप को दिखाता है. यह ज़्यादा से ज़्यादा 500 चैनलों, वीडियो, प्लेलिस्ट या एसेट का कस्टम कलेक्शन है.

ग्रुप के सभी आइटम के लिए, एक ही तरह का संसाधन इस्तेमाल किया जाना चाहिए. उदाहरण के लिए, आप 100 वीडियो और 100 प्लेलिस्ट वाला ग्रुप नहीं बना सकते.

किसी Analytics ग्रुप में सिर्फ़ ऐसे संसाधन शामिल हो सकते हैं जिन्हें आपने अपलोड किया है या जिन पर दावा किया है. ये वे संसाधन भी हो सकते हैं जो आपके मैनेज किए जाने वाले चैनल से जुड़े हैं. इस वजह से, चैनल के मालिक वीडियो और प्लेलिस्ट के ग्रुप बना सकते हैं. कॉन्टेंट के मालिक वीडियो, प्लेलिस्ट, चैनल या एसेट का ग्रुप बना सकते हैं.

इस संसाधन के बारे में ज़्यादा जानकारी के लिए, इसके संसाधन का प्रतिनिधित्व और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://youtubeanalytics.googleapis.com/v2 से जुड़े यूआरआई
list GET /groups एपीआई अनुरोध के पैरामीटर से मैच करने वाले ग्रुप की सूची दिखाता है. उदाहरण के लिए, आप उन सभी ग्रुप को फिर से पा सकते हैं जिनका मालिकाना हक पुष्टि किए गए उपयोगकर्ता के पास है. आप चाहें, तो एक या ज़्यादा ग्रुप को उनके यूनीक आईडी से फिर से पा सकते हैं.
insert POST /groups YouTube Analytics ग्रुप बनाता है. ग्रुप बनाने के बाद, ग्रुप में आइटम जोड़ने के लिए groupItems.insert तरीका इस्तेमाल करें.
update PUT /groups किसी ग्रुप के मेटाडेटा में बदलाव करता है. फ़िलहाल, ग्रुप का शीर्षक ही प्रॉपर्टी की जानकारी अपडेट किया जा सकता है. (ग्रुप आइटम को जोड़ने और हटाने के लिए, groupItems.insert और groupItems.delete का इस्तेमाल करें.)
delete DELETE /groups किसी ग्रुप को मिटाता है.

ग्रुप आइटम

groupItem रिसॉर्स, YouTube Analytics ग्रुप में मौजूद किसी आइटम को दिखाता है.

इस संसाधन के बारे में ज़्यादा जानकारी के लिए, इसके संसाधन का प्रतिनिधित्व और प्रॉपर्टी की सूची देखें.

तरीका एचटीटीपी अनुरोध ब्यौरा
https://youtubeanalytics.googleapis.com/v2 से जुड़े यूआरआई
list GET /groupItems एपीआई अनुरोध के पैरामीटर से मैच करने वाले ग्रुप आइटम का कलेक्शन दिखाता है.
insert POST /groupItems कोई ग्रुप आइटम बनाता है.
delete DELETE /groupItems ग्रुप से किसी आइटम को हटाता है.