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 से जुड़े हुए हैं.

jobs

तरीके
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
उन रिपोर्ट टाइप की सूची दिखाता है जिन्हें चैनल या कॉन्टेंट का मालिक ऐक्सेस कर सकता है.