YouTube Reporting API

YouTube Reporting API की मदद से, डेवलपर रिपोर्टिंग के कामों को शेड्यूल कर सकते हैं. इसके बाद, वे जनरेट की गई बल्क रिपोर्ट डाउनलोड कर सकते हैं. API में, पहले से तय की गई रिपोर्ट का एक सेट होता है. इनमें से हर रिपोर्ट में, चैनल या कॉन्टेंट के मालिक के लिए YouTube Analytics का पूरा डेटा होता है.

रिपोर्टिंग जॉब शेड्यूल करने और रिपोर्ट वापस पाने का तरीका यहां बताया गया है:

  1. reportTypes.list() तरीके को कॉल करके, उन रिपोर्ट की सूची पाएं जिन्हें कोई चैनल या कॉन्टेंट का मालिक वापस पा सकता है.
  2. jobs.create() तरीके को कॉल करके, उस रिपोर्ट की पहचान करें जिसे किसी चैनल या कॉन्टेंट के मालिक के लिए जनरेट किया जाना चाहिए. इसके बाद, जनरेट की जा रही रिपोर्ट की सूची को वापस पाने या उसमें बदलाव करने के लिए, एपीआई के jobs.list() और jobs.delete() का इस्तेमाल किया जा सकता है.
  3. किसी नौकरी के लिए जनरेट की गई रिपोर्ट की सूची पाने के लिए, jobs.reports.list() तरीके को कॉल करें. जवाब में मौजूद हर संसाधन में एक downloadUrl प्रॉपर्टी होती है. यह प्रॉपर्टी, उस यूआरएल के बारे में बताती है जहां से रिपोर्ट डाउनलोड की जा सकती है.
  4. डाउनलोड यूआरएल से रिपोर्ट पाने के लिए, अनुमति वाला GET अनुरोध भेजें.

अनुमति देना

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

YouTube Reporting 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://youtubereporting.googleapis.com से जुड़े हुए हैं.

नौकरियां

तरीके
create POST /v1/jobs
इससे रिपोर्टिंग जॉब बनाई जाती है. रिपोर्टिंग जॉब बनाने का मतलब है कि आपने YouTube को हर दिन वह रिपोर्ट जनरेट करने का निर्देश दिया है. जॉब बनाने के 24 घंटे के अंदर रिपोर्ट उपलब्ध हो जाती है.
delete DELETE /v1/jobs/{jobId}
इस तरीके का इस्तेमाल करके, रिपोर्टिंग जॉब को मिटाया जा सकता है.
get GET /v1/jobs/{jobId}
इस तरीके से, किसी ऐसे रिपोर्टिंग जॉब के बारे में जानकारी मिलती है जिसे किसी चैनल या कॉन्टेंट के मालिक के लिए शेड्यूल किया गया है.
list GET /v1/jobs
इस फ़ंक्शन से, किसी चैनल या कॉन्टेंट के मालिक के लिए शेड्यूल की गई रिपोर्टिंग जॉब की सूची मिलती है. जवाब में मौजूद हर संसाधन में एक id प्रॉपर्टी होती है. यह प्रॉपर्टी, उस आईडी के बारे में बताती है जिसका इस्तेमाल YouTube, नौकरी की खास तौर पर पहचान करने के लिए करता है. आपको इस आईडी की ज़रूरत, नौकरी के लिए जनरेट की गई रिपोर्ट की सूची पाने या नौकरी को मिटाने के लिए होती है.

jobs.reports

तरीके
get GET /v1/jobs/{jobId}/reports/{reportId}
किसी रिपोर्ट के लिए मेटाडेटा वापस लाता है.
list GET /v1/jobs/{jobId}/reports
इस फ़ील्ड में, उस रिपोर्ट की सूची होती है जिसे रिपोर्टिंग जॉब के लिए जनरेट किया गया है.

reportTypes

तरीके
list GET /v1/reportTypes
इस फ़ंक्शन से, रिपोर्ट टाइप की एक सूची मिलती है. इस सूची में वे रिपोर्ट टाइप शामिल होते हैं जिन्हें चैनल या कॉन्टेंट का मालिक वापस पा सकता है.