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 को जनरेट करना चाहिए. इसके बाद 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 हर काम के लिए रोज़ रिपोर्ट जनरेट करता है. इन्हें एसिंक्रोनस तरीके से डाउनलोड किया जा सकता है.
तारीख सीमाएं	कुछ एपीआई रिपोर्ट में, उपयोगकर्ता गतिविधि की तारीख की जानकारी होती है. इनमें से कुछ रिपोर्ट, महीने के हिसाब से उपयोगकर्ता गतिविधि की मेट्रिक को एग्रीगेट करने के लिए डाइमेंशन के साथ काम करती हैं.	सभी एपीआई रिपोर्ट में, उपयोगकर्ता की गतिविधि वाले दिन की जानकारी होती है. एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन, समय-समय पर डेटा इकट्ठा करने के लिए सुविधाएं लागू कर सकते हैं.
डेटा फ़िल्टर करना	रिपोर्ट को फ़िल्टर करके, सिर्फ़ उन लाइनों को शामिल किया जा सकता है जिनके लिए डाइमेंशन की एक खास वैल्यू तय की गई हो. यह एपीआई, महाद्वीप और subContinent जैसे कुछ डाइमेंशन के साथ भी काम करता है. इन डाइमेंशन का इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर किया जाता है.	यह एपीआई, पूरे डेटा सेट को एक साथ डाउनलोड करने की सुविधा देता है. यह सिर्फ़ फ़िल्टर वाले डाइमेंशन के लिए, डेटा को फ़िल्टर करने या दिखाने की सुविधा नहीं देती. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को स्टोर करता है और डेटा को फ़िल्टर करने के लिए अपनी सुविधाएं उपलब्ध कराता है.
क्रम से लगाना	मेट्रिक की वैल्यू के हिसाब से, रिपोर्ट को क्रम से लगाया जा सकता है. कुछ रिपोर्ट में सीमित नतीजे ही दिखते हैं. उदाहरण के लिए, किसी चैनल के सबसे ज़्यादा देखे गए वीडियो की रिपोर्ट में ज़्यादा से ज़्यादा 200 पंक्तियां दिख सकती हैं.	इस एपीआई का इस्तेमाल करके, पूरे डेटा सेट को एक साथ डाउनलोड किया जा सकता है. क्लाइंट ऐप्लिकेशन, डाउनलोड किए गए डेटा को क्रम से लगाने के लिए अपनी सुविधाएं लागू कर सकते हैं.
गिनती	एपीआई रिपोर्ट में, टेक्स्ट वैल्यू होती हैं, जैसे कि "ANDROID" या "CHANNEL". इससे, गिनती वाली डाइमेंशन वैल्यू की पहचान की जा सकती है.	एपीआई रिपोर्ट में ऐसे पूर्णांक होते हैं जिन्हें टेक्स्ट वैल्यू के साथ मैप किया जा सकता है.
अनुरोध भेजने की तय सीमा (कोटा)	एपीआई सर्वर हर क्वेरी का आकलन करके, उसके कोटा की कीमत तय करता है. कोटे के इस्तेमाल वाले सेक्शन में, तरीके के बारे में ज़्यादा जानकारी दी गई है.	कोटा के इस्तेमाल से कोई समस्या नहीं है, क्योंकि डेटा को एक बार फिर से हासिल किया जाता है. इसके बाद, डेटा को ऐप्लिकेशन में फ़िल्टर किया जाता है, क्रम से लगाया जाता है, और क्वेरी किया जाता है.
यूनीक रिपोर्ट		सबटाइटल से जुड़ी उपयोगकर्ता की गतिविधि प्लेलिस्ट के लिए, दर्शक बनाए रखने से जुड़ा डेटा कॉन्टेंट के मालिकों के लिए अनुमानित रेवेन्यू की रिपोर्ट (दो अलग-अलग रिपोर्ट उपलब्ध हैं) कॉन्टेंट के मालिकों के लिए एसेट रिपोर्ट (11 अलग-अलग रिपोर्ट उपलब्ध हैं)
यूनीक डाइमेंशन	ग्रुप (फ़िल्टर-ओनली डाइमेंशन) महाद्वीप (सिर्फ़ फ़िल्टर वाला डाइमेंशन) subContinent (सिर्फ़ फ़िल्टर वाला डाइमेंशन) महीना isCurated==1 (सिर्फ़ फ़िल्टर वाला डाइमेंशन) viewsPerPlaylistStart averageTimeInPlaylist	annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language
यूनीक मेट्रिक	यूनीक relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist	card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_ टीज़र_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue/playlist_16}चुना गया_partner_doubleclick_revenue/playlist_16}हटाया गया playlist_saves_removed

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

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

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

डाइमेंशन

YouTube Analytics एपीआई का नाम	YouTube Reporting API का नाम
adType	ad_type
ageGroup	age_group
ऐसेट	asset_id
audienceType	audience_retention_type
चैनल	channel_id
claimedStatus	claimed_status
contentOwner	content_owner_id
country	country_code
दिन	तारीख
deviceType	device_type
elapsedVideoTimeRatio	elapsed_video_time_percentage
लिंग	लिंग
insightPlaybackLocationDetail	playback_location_detail
insightPlaybackLocationType	playback_location_type
insightTrafficSourceDetail	traffic_source_detail
insightTrafficSourceType	traffic_source_type
liveOrOnDemand	live_or_on_demand
operatingSystem	operating_system
प्लेलिस्ट	playlist_id
province	province_code
sharingService	sharing_service
subscribedStatus	subscribed_status
subtitleLanguage	subtitle_language
uploaderType	uploader_type
वीडियो	video_id

मेट्रिक

YouTube Analytics एपीआई का नाम	YouTube Reporting API का नाम
adEarnings	estimated_partner_ad_revenue
annotationImpressions	annotation_impressions
annotationClickableImpressions	annotation_clickable_impressions
annotationClicks	annotation_clicks
annotationClickThroughRate	annotation_click_through_rate
annotationClosableImpressions	annotation_closable_impressions
annotationCloses	annotation_closes
annotationCloseRate	annotation_close_rate
audienceWatchRatio	audience_retention_percentage
averageViewDuration	average_view_duration_seconds
averageViewPercentage	average_view_duration_percentage
cardClickRate	card_click_rate
cardClicks	card_clicks
cardImpressions	card_impressions
cardTeaserClickRate	card_teaser_click_rate
cardTeaserClicks	card_teaser_clicks
cardTeaserImpressions	card_teaser_impressions
टिप्पणियां	टिप्पणियां
नापसंद	नापसंद
आय	estimated_partner_revenue
estimatedMinutesWatched	watch_time_minutes
estimatedPartnerAdSenseRevenue	estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue	estimated_partner_doubleclick_revenue
grossRevenue	estimated_youtube_ad_revenue
impressionBasedCpm	estimated_cpm
इंप्रेशन	ad_impressions
पसंद	पसंद
monetizedPlaybacks	estimated_monetized_playbacks
playbackBasedCpm	estimated_playback_based_cpm
playlistStarts	playlist_starts
savesAdded	playlist_saves_added
savesRemoved	playlist_saves_removed
शेयर	शेयर
subscribersGained	subscribers_gained
subscribersLost	subscribers_lost
videosAddedToPlaylists	videos_added_to_playlists
videosRemovedFromPlaylists	videos_removed_from_playlist
viewerPercentage	views_percentage
व्यू	व्यू