Introduction

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

दोनों एपीआई की मदद से डेवलपर, YouTube Analytics का डेटा हासिल कर सकते हैं. इसके अलावा, दोनों एपीआई, YouTube चैनल के मालिकों और YouTube कॉन्टेंट के मालिकों के साथ काम करते हैं. दोनों एपीआई, YouTube चैनल के मालिकों के पास रिपोर्ट के खास सेट का ऐक्सेस होते हैं:

• चैनल रिपोर्ट में, किसी खास चैनल के लिए उपयोगकर्ता गतिविधि की मेट्रिक शामिल होती हैं.

• कॉन्टेंट का मालिक किसी खास YouTube कॉन्टेंट के मालिक से जुड़े सभी चैनलों के लिए इकट्ठा की गई मेट्रिक की रिपोर्ट देता है. उदाहरण के लिए, कोई रिकॉर्ड लेबल एक ऐसी रिपोर्ट हासिल कर सकता है जिसमें लेबल के सभी कलाकारों के YouTube चैनलों के संयुक्त आंकड़े शामिल हों. कॉन्टेंट के मालिक की कुछ रिपोर्ट में उपयोगकर्ता गतिविधि की मेट्रिक शामिल होती हैं, जबकि दूसरी रिपोर्ट में आय और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक होती हैं.

Reporting API कुछ कॉन्टेंट के मालिकों को, सिस्टम से मैनेज होने वाली विज्ञापन से होने वाली आय की रिपोर्ट ऐक्सेस करने की अनुमति भी देता है. सिस्टम से मैनेज होने वाली रिपोर्ट में मौजूद डेटा, सिर्फ़ Reporting API से वापस पाया जा सकता है.

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

कॉन्टेंट की शिकायत करें

एपीआई जो रिपोर्ट हासिल करता है उनमें दो तरह का डेटा होता है:

• डाइमेंशन एक ऐसा सामान्य मानदंड है जिसका इस्तेमाल डेटा इकट्ठा करने के लिए किया जाता है, जैसे कि उपयोगकर्ता गतिविधि की तारीख या वह देश जहां उपयोगकर्ता मौजूद थे.

  रिपोर्ट में, डेटा की हर लाइन में डाइमेंशन वैल्यू का एक यूनीक कॉम्बिनेशन होता है. इसलिए, हर पंक्ति में मौजूद डाइमेंशन वैल्यू का कॉम्बिनेशन, उस लाइन के लिए मुख्य कुंजी के तौर पर काम करता है.

• मेट्रिक, उपयोगकर्ता की गतिविधि, विज्ञापन की परफ़ॉर्मेंस या अनुमानित आय के अलग-अलग मेज़रमेंट होती हैं. उपयोगकर्ता गतिविधि की मेट्रिक में, वीडियो को मिले व्यू की संख्या और रेटिंग (पसंद और नापसंद) जैसी चीज़ें शामिल होती हैं.

अपने ऐप्लिकेशन के लिए सही एपीआई चुनें

YouTube Analytics API

YouTube Analytics की कस्टम रिपोर्ट जनरेट करने के लिए, YouTube Analytics API रीयल-टाइम टारगेट की गई क्वेरी के साथ काम करता है. एपीआई, फ़िल्टर करने और क्रम से लगाने के पैरामीटर उपलब्ध कराता है. इसलिए, कॉल करने वाले ऐप्लिकेशन को इन फ़ंक्शन के साथ नेटिव तौर पर काम करने की ज़रूरत नहीं होती.

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

YouTube Reporting API

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

हर रिपोर्ट में, पहले से तय फ़ील्ड होते हैं. डेवलपर, रिपोर्टिंग के जॉब शेड्यूल करने के लिए एपीआई का इस्तेमाल करते हैं. हर जॉब उस रिपोर्ट की पहचान करती है जिसे YouTube को जनरेट करना चाहिए. इसके बाद, YouTube हर दिन एक रिपोर्ट जनरेट करता है, जिसे एसिंक्रोनस तरीके से डाउनलोड किया जा सकता है. हर रिपोर्ट में 24 घंटे की यूनीक अवधि का डेटा होता है.

इसके अलावा, कॉन्टेंट के मालिकों के लिए YouTube, सिस्टम से मैनेज होने वाली रिपोर्ट का एक सेट अपने-आप जनरेट करता है. ये रिपोर्ट, उन कॉन्टेंट के मालिकों के लिए जनरेट की जाती हैं जिनके पास YouTube Creator Studio में मौजूद इन रिपोर्ट का ऐक्सेस होता है. इन रिपोर्ट में, प्रोग्राम के हिसाब से अपने-आप होने वाली प्रोसेस के ज़रिए, विज्ञापन से होने वाली आय के डेटा का ऐक्सेस मिलता है.

इस्तेमाल की जा सकने वाली रिपोर्ट

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

ऐसा हो सकता है कि एक एपीआई में मौजूद डेटा दूसरे एपीआई में उपलब्ध न हो. उदाहरण के लिए, YouTube Analytics API की मदद से हर हफ़्ते या हर महीने उपयोगकर्ता गतिविधि की मेट्रिक देखी जा सकती हैं. हालांकि, YouTube Reporting API की मदद से यह डेटा खुद इकट्ठा करना होगा. दूसरी ओर, YouTube Reporting API का इस्तेमाल करके कॉन्टेंट के मालिकों के लिए, ऐसेट रिपोर्ट की सुविधा उपलब्ध है. हालांकि, YouTube Analytics API से यह डेटा उपलब्ध नहीं होता.

रिपोर्ट प्रकार
वीडियो रिपोर्ट	चैनलों (क्वेरी या एक साथ कई) और कॉन्टेंट के मालिकों (क्वेरी या एक साथ कई) के लिए काम करती है. वीडियो रिपोर्ट में, चैनल के वीडियो या कॉन्टेंट के मालिक के वीडियो से जुड़ी सभी उपयोगकर्ताओं की गतिविधियों के आंकड़े दिए जाते हैं. उदाहरण के लिए, इन रिपोर्ट में आपके वीडियो को मिले व्यू की संख्या शामिल होती है. YouTube Analytics API में, कुछ कॉन्टेंट मालिक की वीडियो रिपोर्ट में अनुमानित आय और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक भी शामिल होती हैं.
प्लेलिस्ट की रिपोर्ट	चैनलों (क्वेरी या एक साथ कई) और कॉन्टेंट के मालिकों (क्वेरी या एक साथ कई) के लिए काम करती है. प्लेलिस्ट की रिपोर्ट से, खास तौर पर प्लेलिस्ट से जुड़े वीडियो व्यू के बारे में जानकारी मिलती है. YouTube Reporting API से, प्लेलिस्ट के लिए दर्शक बनाए रखने की रिपोर्ट काम करती है. हालांकि, YouTube Analytics API में इससे मिलती-जुलती रिपोर्ट काम नहीं करती.
विज्ञापन परफ़ॉर्मेंस रिपोर्ट	कॉन्टेंट के मालिकों के लिए (क्वेरी या एक साथ कई). विज्ञापन की परफ़ॉर्मेंस रिपोर्ट, वीडियो चलने के दौरान दिखाए गए विज्ञापनों के लिए इंप्रेशन पर आधारित मेट्रिक मुहैया कराती है. ये मेट्रिक हर विज्ञापन इंप्रेशन की गिनती करती हैं और हर वीडियो प्लेबैक से एक से ज़्यादा इंप्रेशन मिल सकते हैं.
अनुमानित आय की रिपोर्ट	कॉन्टेंट के मालिकों के लिए उपलब्ध है (बल्क). आय की अनुमानित रिपोर्ट में, वीडियो से होने वाली कुल अनुमानित आय बताई जाती है. यह आय Google के बेचे जाने वाले विज्ञापन स्रोतों और बिना विज्ञापन वाले स्रोतों से मिलने वाले वीडियो से मिलती है. इन रिपोर्ट में, विज्ञापन की परफ़ॉर्मेंस से जुड़ी कुछ मेट्रिक भी होती हैं. ध्यान रखें कि सिस्टम से मैनेज होने वाली रिपोर्ट में असल आय होती है.
एसेट रिपोर्ट	कॉन्टेंट के मालिकों के लिए उपलब्ध है (बल्क). एसेट रिपोर्ट में, उन वीडियो की उपयोगकर्ता गतिविधि की मेट्रिक उपलब्ध होती हैं जो कॉन्टेंट के मालिक की एसेट से लिंक होते हैं. अगर कॉन्टेंट के मालिक ने दावा किया है कि वह वीडियो, कॉन्टेंट के मालिक की किसी एसेट से मिलता-जुलता है, तो उसे कॉन्टेंट के मालिक की रिपोर्ट में शामिल किया जाता है. ऐसा हो सकता है कि वीडियो को कॉन्टेंट के मालिक या YouTube इस्तेमाल करने वाले किसी दूसरे व्यक्ति ने अपलोड किया हो.
सिस्टम से मैनेज होने वाली रिपोर्ट	यह सुविधा कॉन्टेंट के उन मालिकों के लिए उपलब्ध है जिनके पास, YouTube के Creator Studio के रिपोर्ट सेक्शन से जुड़ी रिपोर्ट का ऐक्सेस है. सिस्टम से मैनेज होने वाली रिपोर्ट, एसेट और वीडियो से हुई आय का असल डेटा दिखाती हैं. एक अन्य रिपोर्ट, दावा किए गए वीडियो और उन वीडियो से मेल खाने वाली एसेट की सूची बनाती है. ध्यान दें कि फ़िलहाल Creator Studio की सभी रिपोर्ट, एपीआई में उपलब्ध नहीं हैं. ध्यान दें: YouTube, कॉन्टेंट के उन मालिकों के लिए सिस्टम से मैनेज की जाने वाली रिपोर्ट अपने-आप जनरेट करता है जिनके पास Creator Studio में मौजूद उनसे जुड़ी रिपोर्ट का ऐक्सेस होता है. इस वजह से, इन रिपोर्ट को वापस पाने की प्रोसेस, इस सूची में मौजूद दूसरी तरह की रिपोर्ट की प्रोसेस से अलग होती है. ज़्यादा जानकारी के लिए, सिस्टम से मैनेज होने वाली रिपोर्ट के दस्तावेज़ देखें.

मुख्य अंतर

यहां दी गई टेबल में, YouTube Analytics और Reporting API के बीच के अहम अंतर को हाइलाइट किया गया है.

ट्रैक को दिखाएं	YouTube Analytics API	YouTube Reporting API
डेटा वापस पाने की प्रक्रिया	हर एपीआई अनुरोध से, दिखाए जाने वाले डाइमेंशन और मेट्रिक के बारे में जानकारी मिलती है. साथ ही, यह भी पता चलता है कि किस समयावधि के लिए डेटा दिखाया जाएगा.	ऐप्लिकेशन, रिपोर्टिंग जॉब शेड्यूल करते हैं. YouTube हर काम के लिए, रोज़ाना रिपोर्ट जनरेट करता है. इन्हें एसिंक्रोनस तरीके से डाउनलोड किया जा सकता है.
तारीख सीमाएं	कुछ एपीआई रिपोर्ट में, उपयोगकर्ता गतिविधि की तारीख की जानकारी होती है. इनमें से कुछ रिपोर्ट में डाइमेंशन के साथ उपयोगकर्ता गतिविधि की मेट्रिक को महीने के हिसाब से एग्रीगेट किया जा सकता है.	सभी एपीआई रिपोर्ट में, उपयोगकर्ता गतिविधि के दिन की जानकारी होती है. एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन, समय-समय पर डेटा इकट्ठा करने के लिए सुविधाएं लागू कर सकते हैं.
डेटा फ़िल्टर करना	रिपोर्ट को फ़िल्टर करके, सिर्फ़ उन लाइनों को शामिल किया जा सकता है जिनके लिए डाइमेंशन की कोई वैल्यू तय की गई हो. यह एपीआई कुछ डाइमेंशन के साथ भी काम करता है, जैसे कि महाद्वीप और उपमहाद्वीप. इनका इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर किया जाता है.	इस एपीआई का इस्तेमाल करके, एक साथ कई डेटा सेट को डाउनलोड किया जा सकता है. इस नीति में, सिर्फ़-फ़िल्टर वाले डाइमेंशन के लिए, डेटा को फ़िल्टर नहीं किया जा सकता या दिखाया नहीं जा सकता. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को सेव करता है और डेटा को फ़िल्टर करने के लिए अपनी सुविधाएं लागू करता है.
क्रम से लगाना	रिपोर्ट को, दिखाई गई मेट्रिक की वैल्यू के हिसाब से क्रम में लगाया जा सकता है. कुछ रिपोर्ट में सीमित नतीजे ही दिखते हैं. उदाहरण के लिए, किसी चैनल के सबसे ज़्यादा देखे गए वीडियो की सूची दिखाने वाली रिपोर्ट में ज़्यादा से ज़्यादा 200 पंक्तियां दिखती हैं.	इस एपीआई का इस्तेमाल करके, एक साथ कई डेटा सेट को डाउनलोड किया जा सकता है. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को क्रम से लगाने के लिए, अपनी सुविधाएं लागू कर सकते हैं.
गिनती	एपीआई रिपोर्ट में, "ANDROID" या "CHANNEL" जैसे टेक्स्ट वैल्यू होती हैं, ताकि गिनती की गई डाइमेंशन वैल्यू की पहचान की जा सके.	एपीआई रिपोर्ट में ऐसे पूर्णांक होते हैं जिन्हें टेक्स्ट की वैल्यू से मैप किया जा सकता है.
अनुरोध भेजने की तय सीमा (कोटा)	एपीआई सर्वर हर क्वेरी का आकलन करके उसके कोटा की कीमत तय करता है. कोटे का इस्तेमाल सेक्शन में, तरीके के बारे में ज़्यादा जानकारी दी गई है.	कोटा के इस्तेमाल में कोई समस्या नहीं है, क्योंकि डेटा एक बार वापस मिल जाता है. इसके बाद, ऐप्लिकेशन में डेटा को फ़िल्टर करके क्रम से लगाया जाता है और उससे क्वेरी की जाती है.
यूनीक रिपोर्ट		सबटाइटल से जुड़ी उपयोगकर्ता की गतिविधि प्लेलिस्ट के लिए, दर्शक बनाए रखने से जुड़ा डेटा कॉन्टेंट के मालिकों के लिए अनुमानित रेवेन्यू की रिपोर्ट (दो अलग-अलग रिपोर्ट उपलब्ध हैं) कॉन्टेंट के मालिकों के लिए एसेट रिपोर्ट (11 अलग-अलग रिपोर्ट उपलब्ध हैं)
यूनीक डाइमेंशन	ग्रुप (सिर्फ़ फ़िल्टर वाला डाइमेंशन) महाद्वीप (सिर्फ़ फ़िल्टर वाला डाइमेंशन) उपमहाद्वीप (फ़िल्टर-ओनली डाइमेंशन) महीना isCurated==1 (सिर्फ़ फ़िल्टर वाला डाइमेंशन) viewsPerPlaylistStart औसतTimeInPlaylist	anनोटेशन_id anation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language
यूनीक मेट्रिक	यूनीक relative परफ़ॉर्मैंस viewsPerPlaylistStart औसतTimeInPlaylist	_

अलग-अलग एपीआई के नामों में अंतर

फ़िलहाल, डाइमेंशन और मेट्रिक की पहचान करने के लिए, दोनों एपीआई अलग-अलग नाम रखने के तरीकों का इस्तेमाल करते हैं. फ़िलहाल, YouTube Analytics API के नामों में CamCase का इस्तेमाल किया जाता है, जबकि YouTube Reporting API के नामों में अंडरस्कोर से अलग किए गए नामों का इस्तेमाल होता है.

नीचे दी गई टेबल उन अलग-अलग नामों की पहचान करती हैं जिनका इस्तेमाल दोनों एपीआई, एक ही मेट्रिक और डाइमेंशन की पहचान करने के लिए करते हैं. कुछ मामलों में, दोनों नामों के बीच का अंतर, आपको ऊंट के केस से अंडरस्कोर में बदलने के बाद मिलने वाले अंतर से ज़्यादा होगा. उदाहरण के लिए, YouTube Analytics API में video डाइमेंशन को YouTube Reporting API में video_id नाम दिया गया है.

डाइमेंशन

YouTube Analytics API का नाम	YouTube Reporting API का नाम
विज्ञापन का टाइप	ad_type (विज्ञापन का प्रकार)
उम्र समूह	age_group
एसेट	asset_id
ऑडियंस टाइप	audience_retention_type
चैनल	channel_id
दावे की स्थिति	claim_status
contentमालिक	content_owner_id
country	country_code
दिन	तारीख
deviceType	device_type
बीते हुए वीडियो का समय	eलैपd_video_time_percentage
लिंग	लिंग
InightPlaybackLocationDeटेल	playback_location_detail
insightPlaybackLocationType	playback_location_type
insighttrafficSourceDetail	traffic_source_detail से जुड़ा डेटा
insighttrafficSourceType	traffic_source_type
लाइवऑरऑनडिमांड	live_or_on_demand
ऑपरेटिंग सिस्टम	operating_system
प्लेलिस्ट	playlist_id
province	प्रांत_कोड
शेयरिंग सेवा	sharing_service
सदस्यता का स्टेटस	subscribed_status
सबटाइटल की भाषा	subtitle_language
uploaderType	uploader_type
वीडियो	video_id

मेट्रिक

YouTube Analytics API का नाम	YouTube Reporting API का नाम
विज्ञापन से होने वाली आय	estimated_partner_ad_revenue
एनोटेशन के इंप्रेशन	anनोटेशन_इंप्रेशन
एनोटेशन पर क्लिक करने के इंप्रेशन	anation_clickable_impressions
एनोटेशन क्लिक	anनोटेशन_क्लिक
एनोटेशन क्लिकथ्रू दर	anनोटेशन_क्लिक_थ्रू_दर
एनोटेशन क्लोबल इंप्रेशन	anनोटेशन_closable_impressions
एनोटेशन बंद	anनोटेशन_closes
एनोटेशन क्लोज़ रेट	anनोटेशन_close_rate
ऑडियंसवॉच रेशियो	audience_retention_percentage
औसत व्यू अवधि	औसत_view_duration_seconds
औसतViewPercentage	औसत_view_duration_percentage
कार्डक्लिक रेट	card_click_rate
कार्डक्लिक	card_clicks
कार्ड इंप्रेशन	card_impressions
cardTiserक्लिकरेट	card_TLS_click_rate
cardTiserClicks	card_enable_clicks
cardTeesrimpression	card_TLS_impressions
टिप्पणियां	टिप्पणियां
नापसंद	नापसंद
आय	estimated_partner_revenue
estimatedMinutes में देखा गया	watch_time_मिनट
estimatedPartnerAdSenseआय	estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue	estimated_partner_doubleclick_revenue
कुल रेवेन्यू	estimated_youtube_ad_revenue
इंप्रेशन-आधारितCpm	estimated_cpm
इंप्रेशन	ad_impressions
पसंद	पसंद
वीडियो से कमाई करने की सुविधा	estimated_monetized_playbacks
playbackBaseCpm	estimated_playback_based_cpm
प्लेलिस्ट शुरू होने का समय	playlist_starts
सेव किए गए	playlist_saves_जोड़ा गया
savesहटाया गया	playlist_saves_हटाया
शेयर	शेयर
नए सदस्य जुड़े	customer_gained
सदस्यों की संख्या में गिरावट	SUBSCRIPTION_lost
वीडियोप्लेलिस्ट में जोड़ी गई	videos_added_to_playlists
videosRemovedFromप्लेलिस्ट का इस्तेमाल करने का तरीका	videos_हटाया_from_playlist
दर्शक का प्रतिशत	views_percentage
व्यू	व्यू