Introduction

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

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

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

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

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

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

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

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

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

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

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

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

YouTube Analytics API

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

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

YouTube Reporting API

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

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

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

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

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

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

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

मुख्य अंतर

नीचे दी गई टेबल, YouTube Analytics और रिपोर्टिंग एपीआई के बीच के अंतर को हाइलाइट करती है.

सुविधा	YouTube Analytics API	YouTube Reporting API
डेटा वापस पाने की प्रोसेस	हर एपीआई अनुरोध में डाइमेंशन और मेट्रिक के साथ-साथ वह समयावधि भी बताई जाती है जिसके लिए डेटा दिया जाएगा.	ऐप्लिकेशन, रिपोर्टिंग से जुड़े काम शेड्यूल करते हैं. हर काम के लिए, YouTube हर दिन की रिपोर्ट जनरेट करता है. इन्हें डाउनलोड किया जा सकता है.
तारीख सीमाएं	कुछ एपीआई रिपोर्ट में, उपयोगकर्ता गतिविधि की तारीख के बारे में बताया जाता है. इनमें से कुछ रिपोर्ट, उपयोगकर्ता गतिविधि मेट्रिक को महीने के हिसाब से एग्रीगेट करने के लिए, डाइमेंशन के साथ काम करती हैं.	सभी एपीआई रिपोर्ट से पता चलता है कि उपयोगकर्ता गतिविधि किस दिन हुई थी. एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन समय-समय पर डेटा इकट्ठा करने के लिए, सुविधाएं लागू कर सकते हैं.
डेटा फ़िल्टर करना	सिर्फ़ उन पंक्तियों को शामिल करने के लिए, रिपोर्ट को फ़िल्टर किया जा सकता है जिनके लिए डाइमेंशन की कोई खास वैल्यू है. एपीआई, महाद्वीप और उपमहाद्वीप जैसे कुछ डाइमेंशन के साथ भी काम करता है. इनका इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर किया जाता है.	यह एपीआई, पूरे डेटा सेट को एक साथ डाउनलोड करने की सुविधा देता है. यह सिर्फ़ फ़िल्टर वाले डाइमेंशन के लिए, फ़िल्टर करने या लौटाने का डेटा दिखाने की सुविधा नहीं देता. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को सेव करता है और अपनी सुविधाएं लागू करके डेटा को फ़िल्टर करता है.
क्रम से लगाना	रिपोर्ट को दिखाई गई मेट्रिक वैल्यू के आधार पर क्रम से लगाया जा सकता है. कुछ रिपोर्ट सिर्फ़ सीमित नतीजों के साथ काम करती हैं. उदाहरण के लिए, किसी चैनल के सबसे ज़्यादा देखे गए वीडियो की रिपोर्ट में ज़्यादा से ज़्यादा 200 पंक्तियां दिखती हैं.	इस एपीआई से पूरे डेटा सेट को एक साथ डाउनलोड किया जा सकता है. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को क्रम से लगाने के लिए अपनी सुविधाओं का इस्तेमाल कर सकते हैं.
गिनती	एपीआई रिपोर्ट में गिनती किए गए डाइमेंशन की वैल्यू की पहचान करने के लिए, "apple" या "CHANNEL" जैसी टेक्स्ट वैल्यू शामिल होती हैं.	एपीआई रिपोर्ट में ऐसे पूर्णांक होते हैं जिन्हें टेक्स्ट वैल्यू के साथ मैप किया जा सकता है.
अनुरोध भेजने की तय सीमा (कोटा)	एपीआई का सर्वर, कोटा की लागत तय करने के लिए हर क्वेरी का आकलन करता है. कोटा के इस्तेमाल से जुड़े सेक्शन में, तरीके के बारे में ज़्यादा जानकारी दी गई है.	कोटा के इस्तेमाल में कोई समस्या नहीं है, क्योंकि डेटा को एक बार ऐक्सेस करने के बाद, फ़िल्टर किया जाता है, क्रम से लगाया जाता है, और ऐप्लिकेशन में क्वेरी की जाती है.
यूनीक रिपोर्ट		सबटाइटल से जुड़ी उपयोगकर्ता गतिविधि प्लेलिस्ट के लिए, दर्शक बनाए रखने का डेटा कॉन्टेंट के मालिकों के लिए अनुमानित रेवेन्यू की रिपोर्ट (दो अलग-अलग रिपोर्ट उपलब्ध हैं) कॉन्टेंट के मालिकों के लिए एसेट रिपोर्ट (11 अलग-अलग रिपोर्ट उपलब्ध हैं)
यूनीक डाइमेंशन	ग्रुप (सिर्फ़ फ़िल्टर करने वाला डाइमेंशन) महाद्वीप (सिर्फ़ फ़िल्टर करने वाला डाइमेंशन) उपमहाद्वीप (सिर्फ़ फ़िल्टर वाला डाइमेंशन) महीना isCuated==1 (सिर्फ़ फ़िल्टर वाला डाइमेंशन) व्यू हर प्लेलिस्ट शुरू AverageTimeInPlaylist	annotation_id annotation_type asset_id card_id card_type live_or_on_Demand subscribe__status subtitle_language
खास मेट्रिक	यूनीक रिलेटिव रखरखाव की परफ़ॉर्मेंस व्यू हर प्लेलिस्ट के हिसाब से AverageTimeInPlaylist	card_click_rate card_clicks card_impression card_cse_click_rate card_cse_clicks card_twitter_impression estimated_partner_adsense_revenue estimated_partner_doubleclick_revenueसेव किया गया}

एपीआई के बीच नाम के अंतर

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

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

डाइमेंशन

YouTube Analytics एपीआई का नाम	YouTube Reporting API का नाम
विज्ञापन का टाइप	ad_type
ageGroup	age_group (उम्र_समूह)
एसेट	asset_id
ऑडियंस टाइप	audience_retention_type
चैनल	channel_id
दावा की गई स्थिति	claim_status
कॉन्टेंट का मालिक	content_owner_id से जुड़े
country	country_code
दिन	तारीख
डिवाइस टाइप	device_type
बीते हुए वीडियो टाइमटाइम	बीते हुए वीडियो का समय_प्रतिशत_समय
लिंग	लिंग
inightPlaybackLocationDetail	playback_location_detail
inightPlaybackLocationType	playback_location_type
inighttrafficSourceDetail	traffic_source_detail
inighttrafficSourceType	traffic_source_type
liveOrOnDemand	live_or_on_Demand
ऑपरेटिंग सिस्टम	ऑपरेटिंग सिस्टम
प्लेलिस्ट	playlist_id
province	province_code
शेयर करने की सेवा	शार्डिंग_सेवा
सदस्यता की स्थिति	subscribe__status
सबटाइटल की भाषा	subtitle_language
uploaderType	uploader_type
वीडियो	video_id

मेट्रिक

YouTube Analytics एपीआई का नाम	YouTube Reporting API का नाम
विज्ञापन से होने वाली आय	estimated_partner_ad_revenue
annotationimpressions	annotation_impression
annotationClickableimpression	annotation_clickable_impression
annotationClicks	annotation_clicks
annotationClickthroughRate	annotation_click_through_rate
annotationClosableableइंप्रेशन	annotation_closable_impression
annotationCloses	annotation_closes
annotationCloseRate	annotation_close_rate
audienceWatchRatio	audience_retention_percentage
औसत व्यू अवधि	औसत_view_duration_seconds
AverageViewPercentage	औसत_view_duration_percentage
cardClickRate	card_click_rate
cardClicks	card_clicks
कार्ड इंप्रेशन	card_impressions
cardTeaserClickRate	card_referrer_click_rate
cardTeaserClicks	card_टीज़र_क्लिक
cardTeaserइंप्रेशन	card_टीज़र_इंप्रेशन
टिप्पणी	टिप्पणी
नापसंद	नापसंद
आय	estimated_partner_revenue
estimatedMinutesदेखा गया	watch_time_minutes
estimatedPartnerAdSenseRevenue	estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue	estimated_partner_doubleclick_revenue
grosRevenue	estimated_youtube_ad_revenue
impressionBasedCpm	estimated_cpm
इंप्रेशन	ad_impressions
पसंद	पसंद
कमाई करने वाले वीडियो को चलाना	estimated_monetized_playbacks
playbackBasedCpm	estimated_playback_आधारित_cpm
प्लेलिस्ट शुरू करना	playlist_starts
सेव किए गए खाते जोड़े गए	playlist_saves_added
saves हटाया गया	playlist_saves_हटाया गया
शेयर	शेयर
सदस्यों की संख्या	सदस्यों को मिलने वाली संख्या
सदस्यों की संख्या में कमी	सदस्यों की संख्या में कमी
AddToTolists में वीडियो	videos_added_to_playlists
प्लेलिस्ट से वीडियो हटाना	videos_removed_from_playlist
viewerPercentage	व्यू_प्रतिशत में
व्यू	व्यू