YouTube Reporting API

YouTube Reporting 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 यह बताता है कि चैनल या कॉन्टेंट के मालिक, किस तरह की रिपोर्ट वापस पा सकते हैं.