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 |
ग्रुप से किसी आइटम को हटाता है. |