Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

संशोधन इतिहास

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

30 अक्टूबर, 2026

YouTube Reporting API, अब कॉन्टेंट के मालिकों के लिए, सिस्टम से मैनेज की जाने वाली इन रिपोर्ट के साथ काम करता है:

कैटगरी	रिपोर्ट का नाम	रिपोर्ट टाइप आईडी
वित्तीय खास जानकारी	चैनल में हर महीने हुए बदलावों की खास जानकारी	`content_owner_channel_adjustments_summary_a1`
वित्तीय खास जानकारी	पैसे चुकाकर ली जाने वाली सुविधाओं से हर महीने होने वाले लेन-देन से मिला रेवेन्यू	`content_owner_transactions_paid_features_revenue_a1`
वित्तीय खास जानकारी	देश के हिसाब से, हर महीने टीवीओडी लेन-देन से मिलने वाला रेवेन्यू	`tvod_content_owner_country_title_tvod_revenue_a1`
वित्तीय खास जानकारी	देश के हिसाब से, टीवीओडी लेन-देन से हर महीने मिलने वाला रेवेन्यू	`tvod_content_owner_country_transactions_tvod_revenue_a1`
शॉर्ट वीडियो	संगीत लेबल की किसी एसेट का इस्तेमाल करके, हर महीने बनाए गए शॉर्ट वीडियो	`music_content_owner_shorts_asset_creations_a1`
शॉर्ट वीडियो	संगीत लेबल के शॉर्ट वीडियो की ऐसेट पर हर महीने मिले व्यू	`music_content_owner_shorts_asset_views_a1`
शॉर्ट वीडियो	म्यूज़िक पब्लिशर की एसेट का इस्तेमाल करके, हर महीने बनाए गए शॉर्ट वीडियो	`publisher_content_owner_shorts_asset_creations_a1`
शॉर्ट वीडियो	म्यूज़िक पब्लिशर के लिए, शॉर्ट वीडियो में इस्तेमाल की गई ऐसेट को हर महीने मिले व्यू की रिपोर्ट	`publisher_content_owner_shorts_asset_views_a1`
टैक्स	एमसीएन से जुड़े सहयोगी चैनलों को टैक्स पर मिलने वाले रिफ़ंड की खास जानकारी देने वाली हर महीने की रिपोर्ट	`content_owner_affiliate_tax_refund_summary_a1`
ऐसेट	हर हफ़्ते मिलने वाली एसआरएमएफ़ रिपोर्ट	`publisher_content_owner_weekly_srmf`
ऐसेट	ओएसी के अनुरोध की स्थिति की रोज़ाना की रिपोर्ट	`content_owner_oac_request_status_a1`
ऐसेट	ओएसी के लिए हर दिन किए जाने वाले अनुरोधों की क्वालिटी रिपोर्ट	`content_owner_oac_quality_status_a1`

13 सितंबर, 2026

YouTube Reporting API अब कॉन्टेंट के मालिकों (content_owner_active_references_a2) के लिए, हर हफ़्ते मिलने वाली रेफ़रंस रिपोर्ट के वर्शन 1.1 के साथ काम करता है.

वर्शन 1.1 में ये बदलाव किए गए हैं:

यह status_detail फ़ील्ड जोड़ता है. इससे रेफ़रंस फ़ाइल की स्थिति के बारे में ज़्यादा जानकारी या वजह मिलती है.
यह अपडेट, asset_owners फ़ील्ड में पार्टनर कोड के बजाय, कॉन्टेंट के मालिक के डिसप्ले नेम या बाहरी आईडी का इस्तेमाल करने की सुविधा देता है.

रिपोर्ट का पिछला वर्शन, वर्शन 1.0 (content_owner_active_references_a1) अब भी उपलब्ध है.

9 सितंबर, 2026

YouTube Analytics API और YouTube Reporting API के दस्तावेज़ों को अपडेट कर दिया गया है. इनमें ये बदलाव और जानकारी जोड़ी गई है:

डेटा के अपडेट होने की दर और इंतज़ार के समय का एसएलए: डेटा मॉडल में एक खास सेक्शन जोड़ा गया है. इसमें डेटा प्रोसेसिंग में 48 से 72 घंटे की देरी, आखिरी तारीख को पूरी तरह से प्रोसेस किए गए आखिरी दिन तक छोटा करने के बारे में बताया गया है. साथ ही, रीयल-टाइम में वीडियो के आंकड़े पाने के लिए, YouTube Data API videos.list तरीके का सुझाव दिया गया है.
चैनल की रिपोर्ट में कमाई से जुड़ी मेट्रिक: हमने चैनल की रिपोर्ट को अनुमति देने से जुड़े दस्तावेज़ को अपडेट किया है. इससे यह साफ़ तौर पर पता चलता है कि अगर कोई चैनल YouTube Partner Program (YPP) का सदस्य है, तो https://www.googleapis.com/auth/yt-analytics-monetary.readonly स्कोप के साथ अनुमति वाले चैनल की रिपोर्ट के लिए, अनुमानित रेवेन्यू और विज्ञापन की परफ़ॉर्मेंस मेट्रिक काम करती हैं. साथ ही, कमाई न करने वाले चैनल, एचटीटीपी 403 Forbidden दिखाते हैं.
क्वेरी से जुड़ी पाबंदियां और पैरामीटर के साथ काम करने की सुविधा: रिपोर्ट टेबल को समझना लेख में एक सलाह जोड़ी गई है. इसमें बताया गया है कि अमान्य या एक-दूसरे से अलग डाइमेंशन, मेट्रिक, और फ़िल्टर के कॉम्बिनेशन, एचटीटीपी 400 badRequest ("The query is not supported.") दिखाते हैं.
बल्क रिपोर्ट में डाइमेंशन की वैल्यू खाली होना: हमने YouTube Reporting API की रिपोर्ट की विशेषताओं को अपडेट किया है. इससे यह पता चलता है कि video_id या channel_id जैसे डाइमेंशन कॉलम में खाली स्ट्रिंग होती हैं. ऐसा इसलिए किया जाता है, ताकि मिटाए गए संसाधनों के लिए एग्रीगेट की गई मेट्रिक की संख्या को सुरक्षित रखा जा सके और चैनल-लेवल के इवेंट दिखाए जा सकें.

27 अगस्त, 2026

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

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

YouTube Partner Program में शामिल होने की ज़रूरी शर्तों में कोई बदलाव नहीं किया गया है. YouTube Partner Program में शामिल होने की ज़रूरी शर्तों को अब "शॉर्ट वीडियो को मिले मान्य व्यू" और "वीडियो देखने के मान्य घंटे" कहा जाएगा. पहले इन्हें "सार्वजनिक शॉर्ट वीडियो पर मिले मान्य व्यू" और "सार्वजनिक वीडियो देखने के मान्य घंटे" कहा जाता था.

ज़्यादा जानने के लिए, YouTube पर अपने कॉन्टेंट की परफ़ॉर्मेंस के बारे में जानना लेख पढ़ें.

मेट्रिक	स्थिति	ट्रिगर	इनके लिए इस्तेमाल होता है
देखें	अपडेट किया गया	वीडियो, पहले फ़्रेम से चलता है. इसमें वीडियो अपने-आप चलना, पॉइंटर को वीडियो पर रखना, और वीडियो चलाने के लिए क्लिक/टैप करना शामिल है.	सार्वजनिक व्यू की संख्या.
जुड़ाव वाला व्यू	अपरिवर्तित.	वीडियो पहले फ़्रेम के बाद भी चलता रहता है या उपयोगकर्ता वीडियो चलाने के लिए क्लिक/टैप करता है.	YouTube Partner Program के ज़रिए कमाई करने की सुविधा, ज़्यादातर मुख्य Analytics (क्लिक मिलने की दर, वीडियो देखने में बिताया गया औसत समय), और यूज़र ऐक्टिविटी की रिपोर्टिंग.
थंबनेल इंप्रेशन	अपरिवर्तित.	थंबनेल, इंटरैक्शन या वीडियो अपने-आप चलने की सुविधा के बिना दिखता है.	यह फ़ीड-लेवल पर एक्सपोज़र और पैकेजिंग को मेज़र करता है.

एपीआई दस्तावेज़ से जुड़े अपडेट: हमने YouTube Analytics API की मेट्रिक और YouTube Reporting API की मेट्रिक के दस्तावेज़ में, engagedViews मेट्रिक की परिभाषा को अपडेट किया है.

25 जून, 2026

YouTube Analytics API (टारगेट की जाने वाली क्वेरी) के दस्तावेज़ को अपडेट कर दिया गया है. इसमें कॉन्टेंट के मालिकों के लिए, शहर के हिसाब से उपयोगकर्ता गतिविधि की रिपोर्ट को हटा दिया गया है. यह रिपोर्ट, कॉन्टेंट के मालिकों के लिए उपलब्ध नहीं है. अगर कॉन्टेंट का मालिक, शहर के हिसाब से उपयोगकर्ता गतिविधि के बारे में क्वेरी करता है, तो उसे कोई नतीजा नहीं मिलेगा.

9 मार्च, 2026

ageGroup (YouTube Analytics API) और age_group (YouTube Reporting API) डाइमेंशन में अब वे उपयोगकर्ता भी शामिल हैं जिनकी उम्र YouTube के अनुमान के मुताबिक 18 साल से कम है.

15 जनवरी, 2026

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

चैनलों के लिए, channel_reach_basic_a1 और channel_reach_combined_a1 रिपोर्ट उपलब्ध हैं.
कॉन्टेंट के मालिकों के लिए, content_owner_reach_basic_a1 और content_owner_reach_combined_a1 रिपोर्ट उपलब्ध हैं.

इन रिपोर्ट में ये नई मेट्रिक शामिल हैं:

video_thumbnail_impressions
video_thumbnail_impressions_ctr

22 सितंबर, 2025

रिपोर्ट बंद करने की समयसीमा को 30 सितंबर, 2025 से बढ़ाकर 31 अक्टूबर, 2025 कर दिया गया है. इस बारे में पहले ही एलान किया जा चुका है. शॉर्ट वीडियो के व्यू की गिनती में हुए बदलावों के लिए अपडेट की गई रिपोर्ट के पिछले वर्शन, तब तक उपलब्ध रहेंगे. हालांकि, दावे की रिपोर्ट का वर्शन 1.0 (content_owner_active_claims_a1) और दावे की रिपोर्ट का वर्शन 1.1 (content_owner_active_claims_a2) 30 सितंबर को बंद कर दिया जाएगा.

24 जून, 2025

जैसा कि 26 मार्च, 2025 को एलान किया गया था, Shorts के व्यू की गिनती करने के तरीके में हुए बदलाव के तहत, Bulk Reports API को अपडेट किया जाएगा. ये बदलाव किए गए हैं:

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

Bulk Reports API के लिए, ये बदलाव 30 जून, 2025 से लागू होंगे. इसके हिसाब से, अपनी रिपोर्ट प्रोसेसिंग में बदलाव करना न भूलें.

रिपोर्ट के पिछले वर्शन 30 सितंबर, 2025 तक उपलब्ध रहेंगे. 30 सितंबर, 2025 के बाद, पिछले वर्शन बंद कर दिए जाएंगे. पक्का करें कि आपने नए वर्शन पर माइग्रेट कर लिया हो.

आखिर में, रिपोर्ट प्रोसेस करते समय सबसे सही तरीके अपनाएं. इससे, रिपोर्ट में होने वाले बदलावों की वजह से, आपकी प्रोसेसिंग पाइपलाइन में कोई रुकावट नहीं आएगी.

यहां दी गई टेबल में, हर तरह की रिपोर्ट के लिए रिपोर्ट के नए वर्शन दिखाए गए हैं:

YouTube Analytics के लिए बल्क डेटा रिपोर्ट

चैनल की रिपोर्ट - वीडियो की रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
उपयोगकर्ता गतिविधि	channel_basic_a2	channel_basic_a3
प्रांत के हिसाब से उपयोगकर्ता गतिविधि	channel_province_a2	channel_province_a3
वीडियो चलाने की जगह	channel_playback_location_a2	channel_playback_location_a3
ट्रैफ़िक सोर्स	channel_traffic_source_a2	channel_traffic_source_a3
डिवाइस का टाइप और ऑपरेटिंग सिस्टम	channel_device_os_a2	channel_device_os_a3
सबटाइटल	channel_subtitles_a2	channel_subtitles_a3
मिली-जुली	channel_combined_a2	channel_combined_a3

चैनल की रिपोर्ट - प्लेलिस्ट की रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
उपयोगकर्ता गतिविधि	playlist_basic_a1	playlist_basic_a2
प्रांत के हिसाब से उपयोगकर्ता गतिविधि	playlist_province_a1	playlist_province_a2
वीडियो चलाने की जगह	playlist_playback_location_a1	playlist_playback_location_a2
ट्रैफ़िक सोर्स	playlist_traffic_source_a1	playlist_traffic_source_a2
डिवाइस का टाइप और ऑपरेटिंग सिस्टम	playlist_device_os_a1	playlist_device_os_a2
मिली-जुली	playlist_combined_a1	playlist_combined_a2

कॉन्टेंट के मालिक के लिए रिपोर्ट - वीडियो की रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
उपयोगकर्ता गतिविधि	content_owner_basic_a3	content_owner_basic_a4
प्रांत के हिसाब से उपयोगकर्ता गतिविधि	content_owner_province_a2	content_owner_province_a3
वीडियो चलाने की जगह	content_owner_playback_location_a2	content_owner_playback_location_a3
ट्रैफ़िक सोर्स	content_owner_traffic_source_a2	content_owner_traffic_source_a3
डिवाइस का टाइप और ऑपरेटिंग सिस्टम	content_owner_device_os_a2	content_owner_device_os_a3
सबटाइटल	content_owner_subtitles_a2	content_owner_subtitles_a3
मिली-जुली	content_owner_combined_a2	content_owner_combined_a3

कॉन्टेंट के मालिक के लिए रिपोर्ट - प्लेलिस्ट की रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
उपयोगकर्ता गतिविधि	content_owner_playlist_basic_a1	content_owner_playlist_basic_a2
प्रांत के हिसाब से उपयोगकर्ता गतिविधि	content_owner_playlist_province_a1	content_owner_playlist_province_a2
वीडियो चलाने की जगह	content_owner_playlist_playback_location_a1	content_owner_playlist_playback_location_a2
ट्रैफ़िक सोर्स	content_owner_playlist_traffic_source_a1	content_owner_playlist_traffic_source_a2
डिवाइस का टाइप और ऑपरेटिंग सिस्टम	content_owner_playlist_device_os_a1	content_owner_playlist_device_os_a2
मिली-जुली	content_owner_playlist_combined_a1	content_owner_playlist_combined_a2

कॉन्टेंट के मालिक के लिए रिपोर्ट - ऐसेट रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
उपयोगकर्ता गतिविधि	content_owner_asset_basic_a2	content_owner_asset_basic_a3
प्रांत के हिसाब से उपयोगकर्ता गतिविधि	content_owner_asset_province_a2	content_owner_asset_province_a3
वीडियो चलाने की जगह	content_owner_asset_playback_location_a2	content_owner_asset_playback_location_a3
ट्रैफ़िक सोर्स	content_owner_asset_traffic_source_a2	content_owner_asset_traffic_source_a3
डिवाइस का टाइप और ऑपरेटिंग सिस्टम	content_owner_asset_device_os_a2	content_owner_asset_device_os_a3
मिली-जुली	content_owner_asset_combined_a2	content_owner_asset_combined_a3

सिस्टम से मैनेज की जाने वाली रिपोर्ट - वित्तीय (संगीत के अलावा अन्य कॉन्टेंट के लिए)

कॉन्टेंट के मालिक के लिए रिपोर्ट - शॉर्ट वीडियो से जुड़ी रिपोर्ट (म्यूज़िक पार्टनर के अलावा अन्य क्रिएटर्स के लिए)
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
विज्ञापन से मिलने वाले ग्लोबल रेवेन्यू की खास जानकारी	content_owner_shorts_global_ad_revenue_summary_a1	content_owner_shorts_global_ad_revenue_summary_a2
विज्ञापन से मिलने वाले रेवेन्यू की रोज़ाना की खास जानकारी	content_owner_shorts_day_ad_revenue_summary_a1	content_owner_shorts_day_ad_revenue_summary_a2
देश के हिसाब से, विज्ञापन से मिलने वाले रेवेन्यू की खास जानकारी	content_owner_shorts_country_ad_revenue_summary_a1	content_owner_shorts_country_ad_revenue_summary_a2
विज्ञापन से मिलने वाले रेवेन्यू की खास जानकारी	content_owner_shorts_ad_revenue_summary_a1	content_owner_shorts_ad_revenue_summary_a2

सिस्टम से मैनेज की जाने वाली रिपोर्ट - गैर-वित्तीय

कॉन्टेंट के मालिक के लिए रिपोर्ट - दावों की रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
सक्रिय दावे	content_owner_active_claims_a2	content_owner_active_claims_a3

कॉन्टेंट के मालिक के लिए रिपोर्ट - वीडियो के मेटाडेटा की रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
वीडियो मेटाडेटा	content_owner_video_metadata_a3	content_owner_video_metadata_a4

कॉन्टेंट के मालिक के लिए रिपोर्ट - ऐसेट रिपोर्ट
रिपोर्ट का नाम	पिछला वर्शन	नया वर्शन
ऐसेट	content_owner_asset_a2	content_owner_asset_a3
एसेट को लेकर हुए विवाद	content_owner_asset_conflict_a2	content_owner_asset_conflict_a3

24 अप्रैल, 2025

26 मार्च, 2025 को किए गए एलान के मुताबिक, Targeted Queries API को अपडेट किया जाएगा. ऐसा Shorts के व्यू की गिनती करने के तरीके में किए गए बदलाव के तहत किया जाएगा:

शॉर्ट वीडियो के लिए, views की गिनती अब इस आधार पर की जाएगी कि कोई शॉर्ट वीडियो कितनी बार चलाया गया या उसे कितनी बार दोबारा देखा गया.
एक नई मेट्रिक, engagedViews, व्यू की गिनती करने के पुराने तरीके को दिखाएगी. engagedViews को views के साथ सभी रिपोर्ट में उपलब्ध कराया जाएगा.

टारगेट की जाने वाली क्वेरी के एपीआई के लिए, ये बदलाव 30 अप्रैल, 2025 से लागू होंगे. अपनी क्वेरी में उसी हिसाब से बदलाव करें.

बदलावों का यह इतिहास देखें और जानें कि Bulk Reports API में क्या बदलाव किए जाएंगे और कब किए जाएंगे.

22 अप्रैल, 2025

7 अप्रैल, 2024 को किए गए एलान के मुताबिक, चैनल की रिपोर्ट और कॉन्टेंट के मालिक की प्लेलिस्ट की रिपोर्ट के लिए, isCurated डाइमेंशन को बंद कर दिया गया है. यह डाइमेंशन 31 दिसंबर, 2024 से काम नहीं करेगा. इस डाइमेंशन को रिपोर्ट और दस्तावेज़ों से हटा दिया गया है.

26 मार्च, 2025

इस अपडेट में, YouTube Analytics और Reporting API से जुड़े ये बदलाव शामिल हैं:

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

YouTube Analytics (टारगेट की जाने वाली क्वेरी) और Reporting (बल्क रिपोर्ट) एपीआई में ये बदलाव किए जाएंगे:

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

टारगेट की जाने वाली क्वेरी 30 अप्रैल तक और बल्क रिपोर्ट 30 जून तक अपडेट कर दी जाएंगी. तब तक व्यू की संख्या, पुराने तरीके के हिसाब से ही गिनी जाएगी. शॉर्ट वीडियो और चैनल के व्यू, Studio में Analytics से मैच नहीं होंगे.

इसके अलावा, Daily Claims (वर्शन 1.0) रिपोर्ट को बंद करने का जो एलान पहले किया गया था उसे लागू करने में देरी हुई है.

एपीआई में किए गए बदलावों की जानकारी पाने के लिए, बदलावों का यह इतिहास देखें.

3 मार्च, 2025

इस अपडेट में, YouTube Reporting API से जुड़ा यह बदलाव शामिल है:

ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

पार्टनर के लिए, रोज़ाना किए गए दावों की रिपोर्ट (वर्शन 1.0) को बंद कर दिया गया है. यह 30 अप्रैल, 2025 से काम नहीं करेगा. इसके हिसाब से, उस रिपोर्ट की परिभाषा को अपडेट कर दिया गया है. इसके बजाय, हर दिन के दावों की नई रिपोर्ट का इस्तेमाल करें.

15 नवंबर, 2024

ध्यान दें: यह बदलाव 18 नवंबर, 2024 से लागू होगा.

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि ट्रैफ़िक सोर्स की रिपोर्ट के लिए, API का reports.query तरीका अब गड़बड़ी दिखाता है. ऐसा तब होता है, जब क्वेरी किए गए वीडियो की संख्या और तारीख की सीमा में दिनों की संख्या का गुणनफल 50,000 से ज़्यादा हो. उदाहरण के लिए, 500 वीडियो आईडी का डेटा वापस पाने वाली क्वेरी, ज़्यादा से ज़्यादा 100 दिनों के डेटा का अनुरोध कर सकती है.

इस बदलाव का असर, चैनलों और कॉन्टेंट के मालिकों, दोनों की रिपोर्ट पर पड़ता है.

किसी अनुरोध से मिलने वाली पंक्तियों की संख्या कम करने के लिए, अपनी क्वेरी को कई क्वेरी में बांटें. इनमें कम वीडियो या तारीख की छोटी सीमाएं सेट करें. आम तौर पर, बड़े डेटा सेट के लिए बल्क रिपोर्ट का सुझाव दिया जाता है.

6 मई, 2024

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API, चैनलों के लिए तीन नई रिपोर्ट उपलब्ध कराता है:

डीएमए के हिसाब से उपयोगकर्ता गतिविधि की रिपोर्ट, भौगोलिक रिपोर्ट होती है. इसमें खास तौर पर बनाए गए बाज़ार (डीएमए) के हिसाब से, उपयोगकर्ता गतिविधि के आंकड़े मिलते हैं. इस रिपोर्ट के लिए, आपको filters पैरामीटर की वैल्यू को country==US पर सेट करना होगा.
एक समय पर देख रहे दर्शक रिपोर्ट से, लाइव स्ट्रीम किए गए किसी वीडियो के अलग-अलग हिस्सों को एक समय पर देखने वाले दर्शकों की संख्या का पता चलता है.
सदस्यता रद्द करने वाले लोगों की जानकारी देने वाली रिपोर्ट से, यह पता चलता है कि लोगों ने चैनल की पैसे चुकाकर ली गई सदस्यता क्यों रद्द की.

इस रिपोर्ट में नए membershipsCancellationSurveyReason डाइमेंशन का इस्तेमाल किया जाता है. इससे पता चलता है कि किसी उपयोगकर्ता ने चैनल की सदस्यता क्यों रद्द की. इसमें नई मेट्रिक, membershipsCancellationSurveyResponses का भी इस्तेमाल किया जाता है. इससे पता चलता है कि उस वजह से चैनल की कितनी सदस्यताएं रद्द की गईं.

इसके अलावा, दर्शक बनाए रखने से जुड़ी रिपोर्ट को बेहतर बनाया गया है, ताकि इसमें तीन नई मेट्रिक शामिल की जा सकें:

7 अप्रैल, 2024

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API में, कॉन्टेंट के मालिक की प्लेलिस्ट की रिपोर्ट से जुड़े कई अपडेट किए गए हैं. ये अपडेट, चैनल की प्लेलिस्ट की रिपोर्ट से जुड़े अपडेट जैसे ही हैं. इनका एलान 19 जनवरी, 2024 को किया गया था.

बदलावों के इतिहास की इस एंट्री में, करीब-करीब वही जानकारी दी गई है जो 19 जनवरी, 2024 की एंट्री में दी गई है. हालांकि, ध्यान दें कि कॉन्टेंट के मालिक की प्लेलिस्ट रिपोर्ट में isCurated डाइमेंशन का इस्तेमाल 31 दिसंबर, 2024 तक किया जा सकेगा. वहीं, चैनल की प्लेलिस्ट रिपोर्ट में इस डाइमेंशन का इस्तेमाल 30 जून, 2024 तक किया जा सकेगा.

ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

कॉन्टेंट के मालिक की प्लेलिस्ट की रिपोर्ट के लिए, isCurated डाइमेंशन को बंद कर दिया गया है. यह 31 दिसंबर, 2024 के बाद काम नहीं करेगा. उस डाइमेंशन की परिभाषा को इसके हिसाब से अपडेट कर दिया गया है.

अहम जानकारी: एपीआई अनुरोधों से isCurated डाइमेंशन हटाने पर, आपको अपने ऐप्लिकेशन में कुछ और बदलाव करने होंगे.

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

isCurated डाइमेंशन के अलावा, नई रिपोर्ट में एपीआई की ये सुविधाएं अब काम नहीं करतीं:
- नई चैनल प्लेलिस्ट रिपोर्ट के लिए, जगह के हिसाब से फ़िल्टर करने की सुविधा काम नहीं करती. जैसे, continent और subcontinent.
- चैनल की प्लेलिस्ट की नई रिपोर्ट के लिए, अब redViews और estimatedRedMinutesWatched मेट्रिक का इस्तेमाल नहीं किया जा सकता. ये मेट्रिक, YouTube Studio में उपलब्ध नहीं हैं. इसलिए, इस बदलाव से एपीआई की सुविधाएं, Studio ऐप्लिकेशन में उपलब्ध सुविधाओं के साथ अलाइन हो जाती हैं.
- चैनल की प्लेलिस्ट की रिपोर्ट के लिए, subscribedStatus और youtubeProduct डाइमेंशन अब फ़िल्टर के तौर पर काम नहीं करते. ये फ़िल्टर, YouTube Studio में उपलब्ध नहीं हैं. इसलिए, इस बदलाव से एपीआई की सुविधाएं, Studio ऐप्लिकेशन में उपलब्ध सुविधाओं के मुताबिक हो जाएंगी.
कॉन्टेंट के मालिक की रिपोर्ट के दस्तावेज़ में, प्लेलिस्ट की रिपोर्ट सेक्शन को अपडेट किया गया है. इसमें प्लेलिस्ट की रिपोर्ट के लिए इस्तेमाल की जाने वाली मेट्रिक के बारे में ज़्यादा जानकारी दी गई है:
- एग्रीगेट की गई वीडियो मेट्रिक उपयोगकर्ता गतिविधि और इंप्रेशन मेट्रिक उपलब्ध कराती हैं. ये मेट्रिक, कॉन्टेंट के मालिक की प्लेलिस्ट में मौजूद उन सभी वीडियो के लिए एग्रीगेट की जाती हैं जिनका मालिकाना हक भी उसी कॉन्टेंट के मालिक के पास होता है. एग्रीगेट की गई वीडियो मेट्रिक, सिर्फ़ उन एपीआई अनुरोधों के लिए काम करती हैं जो isCurated डाइमेंशन का इस्तेमाल नहीं करते.
- प्लेलिस्ट में मौजूद वीडियो की मेट्रिक से, प्लेलिस्ट पेज पर उपयोगकर्ता गतिविधि और दिलचस्पी के बारे में पता चलता है. इन मेट्रिक में, प्लेलिस्ट में मौजूद उन वीडियो के व्यू भी शामिल होंगे जिन पर आपका मालिकाना हक नहीं है. हालांकि, ऐसा सिर्फ़ तब होगा, जब वे व्यू प्लेलिस्ट में मिले हों.
- प्लेलिस्ट के लिए उपलब्ध मेट्रिक सेक्शन में, एग्रीगेट की गई वीडियो मेट्रिक और प्लेलिस्ट में मौजूद मेट्रिक के बारे में बताया गया है. ये मेट्रिक, प्लेलिस्ट की रिपोर्ट के लिए उपलब्ध हैं.
कॉन्टेंट के मालिकों के लिए, प्लेलिस्ट की रिपोर्ट में प्लेलिस्ट में मौजूद वीडियो से जुड़ी ये नई मेट्रिक शामिल की गई हैं. ध्यान दें कि ये मेट्रिक सिर्फ़ तब काम करती हैं, जब रिपोर्ट को वापस पाने के लिए एपीआई अनुरोध में isCurated डाइमेंशन का इस्तेमाल नहीं किया जाता है. हर मेट्रिक की परिभाषा जानने के लिए, मेट्रिक से जुड़ा दस्तावेज़ देखें:
views मेट्रिक का व्यवहार अब इस बात पर निर्भर करता है कि प्लेलिस्ट रिपोर्ट को वापस पाने वाले एपीआई अनुरोध में, isCurated डाइमेंशन का इस्तेमाल किया गया है या नहीं:
- जब किसी अनुरोध में isCurated डाइमेंशन शामिल होता है, तो views मेट्रिक, प्लेलिस्ट में मौजूद मेट्रिक होती है. इससे पता चलता है कि कॉन्टेंट के मालिक की प्लेलिस्ट के संदर्भ में वीडियो कितनी बार देखे गए.
- जब किसी अनुरोध में isCurated डाइमेंशन शामिल नहीं होता है, तो views मेट्रिक, एग्रीगेट की गई वीडियो मेट्रिक होती है. इससे पता चलता है कि कॉन्टेंट के मालिक की प्लेलिस्ट में मौजूद वीडियो को कुल कितनी बार देखा गया. भले ही, वे व्यू प्लेलिस्ट के संदर्भ में हुए हों या नहीं. कुल व्यू में सिर्फ़ उन वीडियो के व्यू शामिल होते हैं जिनका मालिकाना हक, प्लेलिस्ट के मालिक चैनल से जुड़े कॉन्टेंट के मालिक के पास होता है.
  
  इन रिपोर्ट में isCurated डाइमेंशन का इस्तेमाल नहीं किया जाता. इनमें playlistViews मेट्रिक से पता चलता है कि प्लेलिस्ट में वीडियो कितनी बार देखे गए. इस मेट्रिक में, प्लेलिस्ट में मौजूद सभी वीडियो के व्यू गिने जाते हैं. इससे कोई फ़र्क़ नहीं पड़ता कि वे वीडियो किस चैनल के हैं.
हर प्लेलिस्ट रिपोर्ट के लिए, कॉन्टेंट के मालिक की रिपोर्ट के दस्तावेज़ में अब ऐसी टेबल शामिल हैं जो उस रिपोर्ट के लिए इस्तेमाल की जा सकने वाली मेट्रिक दिखाती हैं. यह इस बात पर निर्भर करता है कि एपीआई अनुरोध में isCurated डाइमेंशन शामिल है या नहीं. उदाहरण के लिए, समय के हिसाब से प्लेलिस्ट की रिपोर्ट के बारे में बताने वाला सेक्शन देखें.

19 जनवरी, 2024

YouTube Analytics (टारगेट की गई क्वेरी) API में, चैनल की प्लेलिस्ट की रिपोर्ट से जुड़े कई अपडेट किए गए हैं. इन अपडेट में, बंद किया गया एक डाइमेंशन और कई नई और अपडेट की गई मेट्रिक शामिल हैं:

ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

चैनल की रिपोर्ट के लिए, isCurated डाइमेंशन अब काम नहीं करता. यह 30 जून, 2024 या इसके बाद काम नहीं करेगा. उस डाइमेंशन की परिभाषा को इसके हिसाब से अपडेट कर दिया गया है.

अपडेट (2 अप्रैल, 2024): कॉन्टेंट के मालिक की रिपोर्ट के लिए, isCurated डाइमेंशन को भी बंद कर दिया गया है. इन रिपोर्ट के लिए, 31 दिसंबर, 2024 को या इसके बाद, डाइमेंशन का इस्तेमाल नहीं किया जा सकेगा.

अहम जानकारी: एपीआई अनुरोधों से isCurated डाइमेंशन हटाने पर, आपको अपने ऐप्लिकेशन में कुछ और बदलाव करने होंगे.

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

isCurated डाइमेंशन के अलावा, नई रिपोर्ट में एपीआई की ये सुविधाएं अब काम नहीं करतीं:
- नई चैनल प्लेलिस्ट रिपोर्ट के लिए, जगह के हिसाब से फ़िल्टर करने की सुविधा काम नहीं करती. जैसे, continent और subcontinent.
- चैनल की प्लेलिस्ट की नई रिपोर्ट के लिए, अब redViews और estimatedRedMinutesWatched मेट्रिक का इस्तेमाल नहीं किया जा सकता. ये मेट्रिक, YouTube Studio में उपलब्ध नहीं हैं. इसलिए, इस बदलाव से एपीआई की सुविधाएं, Studio ऐप्लिकेशन में उपलब्ध सुविधाओं के साथ अलाइन हो जाती हैं.
- चैनल की प्लेलिस्ट की रिपोर्ट के लिए, subscribedStatus और youtubeProduct डाइमेंशन अब फ़िल्टर के तौर पर काम नहीं करते. ये फ़िल्टर, YouTube Studio में उपलब्ध नहीं हैं. इसलिए, इस बदलाव से एपीआई की सुविधाएं, Studio ऐप्लिकेशन में उपलब्ध सुविधाओं के मुताबिक हो जाएंगी.
चैनल की रिपोर्ट से जुड़े दस्तावेज़ के प्लेलिस्ट की रिपोर्ट सेक्शन को अपडेट किया गया है. इसमें प्लेलिस्ट की रिपोर्ट के लिए इस्तेमाल की जा सकने वाली मेट्रिक के बारे में ज़्यादा जानकारी दी गई है:
- एग्रीगेट की गई वीडियो मेट्रिक से, उपयोगकर्ता गतिविधि और इंप्रेशन की मेट्रिक मिलती हैं. ये मेट्रिक, चैनल की प्लेलिस्ट में मौजूद उन सभी वीडियो के लिए एग्रीगेट की जाती हैं जिनका मालिकाना हक भी उसी चैनल के पास होता है. एग्रीगेट की गई वीडियो मेट्रिक, सिर्फ़ उन एपीआई अनुरोधों के लिए काम करती हैं जो isCurated डाइमेंशन का इस्तेमाल नहीं करते.
- प्लेलिस्ट में मौजूद वीडियो की मेट्रिक से, प्लेलिस्ट पेज पर उपयोगकर्ता गतिविधि और दिलचस्पी के बारे में पता चलता है. इन मेट्रिक में, प्लेलिस्ट में मौजूद उन वीडियो के व्यू भी शामिल होंगे जिन पर आपका मालिकाना हक नहीं है. हालांकि, ऐसा सिर्फ़ तब होगा, जब वे व्यू प्लेलिस्ट में मिले हों.
- प्लेलिस्ट के लिए उपलब्ध मेट्रिक सेक्शन में, एग्रीगेट की गई वीडियो मेट्रिक और प्लेलिस्ट में मौजूद मेट्रिक के बारे में बताया गया है. ये मेट्रिक, प्लेलिस्ट की रिपोर्ट के लिए उपलब्ध हैं.
चैनलों की प्लेलिस्ट रिपोर्ट के लिए, प्लेलिस्ट में मौजूद वीडियो की ये नई मेट्रिक इस्तेमाल की जा सकती हैं. फ़िलहाल, कॉन्टेंट के मालिक की रिपोर्ट के लिए ये मेट्रिक उपलब्ध नहीं हैं. ध्यान दें कि ये मेट्रिक सिर्फ़ तब काम करती हैं, जब रिपोर्ट को वापस पाने के लिए एपीआई अनुरोध में isCurated डाइमेंशन का इस्तेमाल नहीं किया जाता है. हर मेट्रिक की परिभाषा जानने के लिए, मेट्रिक से जुड़ा दस्तावेज़ देखें:
views मेट्रिक का व्यवहार अब इस बात पर निर्भर करता है कि प्लेलिस्ट रिपोर्ट को वापस पाने वाले एपीआई अनुरोध में, isCurated डाइमेंशन का इस्तेमाल किया गया है या नहीं:
- जब किसी अनुरोध में isCurated डाइमेंशन शामिल होता है, तो views मेट्रिक, प्लेलिस्ट में मौजूद मेट्रिक होती है. इससे पता चलता है कि चैनल की प्लेलिस्ट के संदर्भ में, वीडियो कितनी बार देखे गए.
- जब किसी अनुरोध में isCurated डाइमेंशन शामिल नहीं होता है, तो views मेट्रिक, एग्रीगेट की गई वीडियो मेट्रिक होती है. इससे पता चलता है कि चैनल की प्लेलिस्ट में मौजूद वीडियो को कुल कितनी बार देखा गया. भले ही, वे व्यू प्लेलिस्ट के संदर्भ में हुए हों या नहीं. कुल व्यू में सिर्फ़ उन वीडियो के व्यू शामिल होते हैं जो उस चैनल के मालिकाना हक वाले हैं जिसके पास प्लेलिस्ट का मालिकाना हक है.
  
  इन रिपोर्ट में isCurated डाइमेंशन का इस्तेमाल नहीं किया जाता. इनमें playlistViews मेट्रिक से पता चलता है कि प्लेलिस्ट में वीडियो कितनी बार देखे गए. इस मेट्रिक में, प्लेलिस्ट में मौजूद सभी वीडियो के व्यू गिने जाते हैं. इससे कोई फ़र्क़ नहीं पड़ता कि वे वीडियो किस चैनल के हैं.
हर प्लेलिस्ट रिपोर्ट के लिए, चैनल रिपोर्ट के दस्तावेज़ में अब ऐसी टेबल शामिल हैं जो उस रिपोर्ट के लिए काम करने वाली मेट्रिक दिखाती हैं. यह इस बात पर निर्भर करता है कि एपीआई अनुरोध में isCurated डाइमेंशन शामिल है या नहीं. उदाहरण के लिए, समय के हिसाब से प्लेलिस्ट की रिपोर्ट के बारे में बताने वाला सेक्शन देखें.

04 दिसंबर, 2023

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API को अपडेट किया गया है, ताकि insightTrafficSourceType डाइमेंशन की दो वैल्यू को मर्ज किया जा सके. पहले, इस डाइमेंशन से यह पता चलता था कि वीडियो को प्लेलिस्ट के हिस्से के तौर पर चलाया गया है (PLAYLIST) या उसे प्लेलिस्ट के सभी वीडियो की सूची वाले पेज से चलाया गया है (YT_PLAYLIST_PAGE). अब दोनों तरह के व्यू, PLAYLIST डाइमेंशन वैल्यू से जुड़े होंगे.

15 दिसंबर, 2022

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API में दो नए डाइमेंशन और एक नई रिपोर्ट जोड़ी गई है:

एक नई रिपोर्ट में, शहर के हिसाब से उपयोगकर्ता गतिविधि की जानकारी मिलती है. यह रिपोर्ट, चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध है. इस रिपोर्ट में नया city डाइमेंशन शामिल है. इससे YouTube को उस शहर का अनुमान लगाने में मदद मिलती है जहां उपयोगकर्ता गतिविधि हुई थी.
नया creatorContentType डाइमेंशन, YouTube कॉन्टेंट के उस टाइप की पहचान करता है जो डेटा लाइन में, उपयोगकर्ता गतिविधि की मेट्रिक से जुड़ा होता है. इस्तेमाल की जा सकने वाली वैल्यू LIVE_STREAM, SHORTS, STORY, और VIDEO_ON_DEMAND हैं.

creatorContentType डाइमेंशन, चैनल और कॉन्टेंट के मालिक की सभी वीडियो रिपोर्ट के लिए, वैकल्पिक डाइमेंशन के तौर पर काम करता है.
YouTube Analytics API के सैंपल अनुरोधों की गाइड में, अब दोनों नए डाइमेंशन के उदाहरण शामिल हैं.
दस्तावेज़ से 7DayTotals और 30DayTotals डाइमेंशन के रेफ़रंस हटा दिए गए हैं. इन डाइमेंशन को बंद करने का एलान अक्टूबर 2019 में किया गया था.

26 अगस्त, 2022

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API और YouTube Reporting (बल्क रिपोर्ट) API, दोनों में ट्रैफ़िक सोर्स की जानकारी की नई वैल्यू का इस्तेमाल किया जा सकता है:

YouTube Analytics API (टारगेट की जाने वाली क्वेरी) एपीआई में, अगर insightTrafficSourceType डाइमेंशन की वैल्यू SUBSCRIBER है, तो insightTrafficSourceDetail वैल्यू को podcasts पर सेट किया जा सकता है. इससे पता चलता है कि ट्रैफ़िक, पॉडकास्ट के डेस्टिनेशन पेज से आया है.
YouTube Reporting (बल्क रिपोर्ट) API में, अगर traffic_source_type डाइमेंशन की वैल्यू 3 है, तो traffic_source_detail वैल्यू को podcasts पर सेट किया जा सकता है. इससे पता चलता है कि ट्रैफ़िक, पॉडकास्ट के डेस्टिनेशन पेज से आया है.

11 फ़रवरी, 2022

gender डाइमेंशन के लिए मान्य वैल्यू का सेट, 11 अगस्त, 2022 को या इसके बाद बदल जाएगा. ऐसा हो सकता है कि एपीआई लागू करने के तरीके में किया गया बदलाव, पुराने सिस्टम के साथ काम न करता हो. YouTube API की सेवाओं की सेवा की शर्तों के पुराने सिस्टम के साथ काम न करने वाले बदलाव सेक्शन के मुताबिक, इस बदलाव का एलान इसके लागू होने से छह महीने पहले किया जा रहा है. कृपया 11 अगस्त, 2022 से पहले अपने एपीआई को अपडेट करें, ताकि वैल्यू के नए सेट पर आसानी से ट्रांज़िशन किया जा सके.

ये बदलाव किए जा रहे हैं:

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API में, gender डाइमेंशन में फ़िलहाल दो वैल्यू इस्तेमाल की जा सकती हैं: female और male. 11 अगस्त, 2022 को या उसके बाद, उस डाइमेंशन के लिए ये तीन वैल्यू इस्तेमाल की जा सकेंगी: female, male, और user_specified.
YouTube Reporting (बल्क रिपोर्ट) API में, फ़िलहाल gender डाइमेंशन के लिए तीन वैल्यू इस्तेमाल की जा सकती हैं: FEMALE, MALE, और GENDER_OTHER. इस्तेमाल की जा सकने वाली वैल्यू का सेट, 11 अगस्त, 2022 को या उसके बाद बदलकर FEMALE, MALE, और USER_SPECIFIED हो जाएगा.

9 फ़रवरी, 2022

दो मेट्रिक को अपडेट किया गया है, ताकि 13 दिसंबर, 2021 से लूप में चलने वाली क्लिप के ट्रैफ़िक को शामिल न किया जाए. इस बदलाव का असर, YouTube Analytics (टारगेट की जाने वाली क्वेरी) एपीआई और YouTube Reporting (बल्क रिपोर्ट) एपीआई, दोनों पर पड़ता है.

YouTube Analytics (टारगेट की जाने वाली क्वेरी) एपीआई में, averageViewDuration और averageViewPercentage मेट्रिक, दोनों में 13 दिसंबर, 2021 से लूप में चलने वाली क्लिप का ट्रैफ़िक शामिल नहीं किया जाता.
YouTube Reporting (बल्क रिपोर्ट) API में, 13 दिसंबर, 2021 से average_view_duration_seconds और average_view_duration_percentage मेट्रिक में लूप में चलने वाली क्लिप का ट्रैफ़िक शामिल नहीं किया जाता.

2 फ़रवरी, 2022

YouTube Reporting (बल्क रिपोर्ट) API, ट्रैफ़िक सोर्स के डाइमेंशन की एक नई वैल्यू के साथ काम करता है. इससे पता चलता है कि व्यू, लाइव रीडायरेक्ट से मिले हैं:

YouTube Reporting (बल्क रिपोर्ट) API में, traffic_source_type डाइमेंशन के लिए 28 वैल्यू का इस्तेमाल किया जा सकता है.

ट्रैफ़िक सोर्स के इस टाइप के लिए, traffic_source_detail डाइमेंशन से उस चैनल आईडी का पता चलता है जिससे दर्शक को रेफ़र किया गया था.

23 सितंबर, 2020

YouTube Analytics (टारगेट की गई क्वेरी) API और YouTube Reporting (बल्क रिपोर्ट) API, दोनों में ट्रैफ़िक सोर्स के डाइमेंशन की नई वैल्यू का इस्तेमाल किया जा सकता है. इससे पता चलता है कि दर्शक को YouTube Shorts में वर्टिकल स्वाइप करके वीडियो देखने के दौरान, आपके वीडियो का सुझाव दिया गया था:

YouTube Analytics API (टारगेट की जाने वाली क्वेरी) एपीआई में, insightTrafficSourceType डाइमेंशन के लिए SHORTS वैल्यू का इस्तेमाल किया जा सकता है.
YouTube Reporting (बल्क रिपोर्ट) API में, traffic_source_type डाइमेंशन के लिए 24 वैल्यू का इस्तेमाल किया जा सकता है.

ट्रैफ़िक सोर्स की जानकारी देने वाला डाइमेंशन — insightTrafficSourceDetail YouTube Analytics API में या traffic_source_detail YouTube Reporting API में — ट्रैफ़िक सोर्स के इस नए टाइप के लिए पॉप्युलेट नहीं किया गया है.

20 जुलाई, 2020

इस अपडेट में दो बदलाव शामिल हैं. इनका असर, YouTube Analytics (टारगेट की जाने वाली क्वेरी) एपीआई पर पड़ता है:

YouTube Analytics रिपोर्टिंग ग्रुप का ज़्यादा से ज़्यादा साइज़, 200 से बढ़ाकर 500 इकाइयों तक कर दिया गया है.
reports.query तरीके का filters पैरामीटर, उन फ़िल्टर की सूची की पहचान करता है जिन्हें YouTube Analytics डेटा को वापस पाने के दौरान लागू किया जाना चाहिए. इस पैरामीटर की मदद से, video, playlist, और channel फ़िल्टर के लिए कई वैल्यू तय की जा सकती हैं. साथ ही, इन फ़िल्टर के लिए तय किए जा सकने वाले आईडी की संख्या 200 से बढ़ाकर 500 कर दी गई है.

13 फ़रवरी, 2020

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

दोनों एपीआई में, सूचनाओं के लिए ट्रैफ़िक सोर्स की जानकारी की संभावित वैल्यू का सेट बदल रहा है. टारगेट की जाने वाली क्वेरी में, सूचनाओं को insightTrafficSourceType=NOTIFICATION के तौर पर रिपोर्ट किया जाता है. बल्क रिपोर्ट में, सूचनाओं को traffic_source_type=17 के तौर पर रिपोर्ट किया जाता है.

नई वैल्यू, अपलोड किए गए वीडियो और लाइव स्ट्रीम से जुड़ी सूचनाओं को दो कैटगरी में बांटती हैं. पहले इन्हें uploaded के तौर पर रिपोर्ट किया जाता था:

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

ये वैल्यू, 13-01-2020 (13 जनवरी, 2020) से शुरू होने वाली समयसीमा के लिए दिखाई जाती हैं.

साथ ही, याद रखें कि ये वैल्यू, सूचनाओं को नहीं दिखाती हैं. इसके बजाय, ये उन ट्रैफ़िक सोर्स को दिखाती हैं जिनकी वजह से YouTube पर वीडियो को व्यू मिले. उदाहरण के लिए, अगर रिपोर्ट की किसी लाइन में views=3, traffic_source_type=17 (NOTIFICATION), और traffic_source_detail=uploaded_push दिख रहा है, तो इसका मतलब है कि वीडियो अपलोड होने पर भेजे गए पुश नोटिफ़िकेशन पर क्लिक करके, दर्शकों ने वीडियो को तीन बार देखा.

15 अक्टूबर, 2019

इस अपडेट में, YouTube Analytics (टारगेट की जाने वाली क्वेरी) API से जुड़े ये बदलाव शामिल हैं:

ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

YouTube, 7DayTotals और 30DayTotals डाइमेंशन के लिए सहायता हटा रहा है. हालांकि, 15 अप्रैल, 2020 तक उन डाइमेंशन का इस्तेमाल करके डेटा वापस पाया जा सकता है. इस तारीख को या इसके बाद, 7DayTotals या 30DayTotals डाइमेंशन का इस्तेमाल करके रिपोर्ट पाने की कोशिश करने पर, गड़बड़ी का मैसेज दिखेगा.

ध्यान दें कि उपयोगकर्ता, day डाइमेंशन का इस्तेमाल करके क्वेरी करके और सात या 30 दिनों की अवधि के डेटा को एग्रीगेट करके या उससे डेटा हासिल करके, इन डाइमेंशन के लिए कुछ डेटा फिर से जनरेट कर सकते हैं. उदाहरण के लिए:
- सात दिनों की अवधि के लिए व्यू की संख्या का हिसाब लगाने के लिए, उस अवधि के हर दिन के व्यू की संख्या को जोड़ें.
- सात दिनों की अवधि के लिए, viewerPercentage का हिसाब लगाने के लिए, हर दिन मिले व्यू की संख्या को उस दिन के viewerPercentage से गुणा करें. इससे आपको उन दर्शकों की संख्या मिलेगी जिन्होंने उस दिन वीडियो देखते समय लॉग इन किया था. इसके बाद, लॉग इन करके वीडियो देखने वाले दर्शकों की संख्या को पूरी अवधि के लिए जोड़ा जा सकता है. साथ ही, उस अवधि के लिए व्यू की कुल संख्या से भाग देकर, पूरी अवधि के लिए viewerPercentage पाया जा सकता है.
- सात दिनों की अवधि के लिए, यूनीक दर्शकों की संख्या का हिसाब नहीं लगाया जा सकता. इसकी वजह यह है कि एक ही दर्शक को अलग-अलग दिनों में यूनीक दर्शक के तौर पर गिना जा सकता है. हालांकि, 30 दिनों की अवधि में यूनीक दर्शकों की संख्या का डेटा निकालने के लिए, 30DayTotals डाइमेंशन के बजाय month डाइमेंशन का इस्तेमाल किया जा सकता है. ध्यान दें कि month डाइमेंशन, कैलेंडर के महीनों के हिसाब से डेटा दिखाता है. वहीं, 30DayTotals डाइमेंशन, शुरू और खत्म होने की तारीख के आधार पर 30 दिनों की अवधि का डेटा दिखाता है.

27 जून, 2019

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

1 नवंबर, 2018

एपीआई का वर्शन 1 अब काम नहीं करता. अगर आपने अब तक ऐसा नहीं किया है, तो कृपया अपने एपीआई क्लाइंट को एपीआई के वर्शन 2 का इस्तेमाल करने के लिए जल्द से जल्द अपडेट करें. इससे सेवा में आने वाली रुकावटों को कम किया जा सकेगा. ज़्यादा जानकारी के लिए, माइग्रेट करने से जुड़ी गाइड देखें.

ध्यान दें कि इस सुविधा को बंद करने के शेड्यूल का एलान, मूल रूप से 26 अप्रैल, 2018 को किया गया था.

17 सितंबर, 2018

डेटा मॉडल की खास जानकारी वाले दस्तावेज़ में, डेटा को पहचान छिपाकर सेव करने के नए सेक्शन में बताया गया है कि मेट्रिक में तय सीमा से कम डेटा होने पर, YouTube Analytics में शायद आपको पूरा डेटा न दिखे. ऐसा कई मामलों में हो सकता है. इसका मतलब है कि किसी रिपोर्ट में आपका पूरा डेटा या कोई भी डेटा शामिल नहीं हो सकता, अगर:
1. किसी तय समयावधि के दौरान, वीडियो या चैनल पर कम ट्रैफ़िक मिला हो,
  
  या
2. आपने कोई ऐसा फ़िल्टर या डाइमेंशन चुना हो जिसकी वैल्यू किसी तय थ्रेशोल्ड को पूरा न करती हो. जैसे, ट्रैफ़िक सोर्स या देश.
इस नए सेक्शन में, उस डेटा के बारे में भी बताया गया है जो YouTube Analytics की रिपोर्ट में सीमित हो सकता है.
चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट के दस्तावेज़ों को अपडेट कर दिया गया है. इससे यह पता चलता है कि वीडियो चलाने की जगह, ट्रैफ़िक सोर्स, और डिवाइस टाइप/ऑपरेटिंग सिस्टम की रिपोर्ट के लिए, redViews और estimatedRedMinutesWatched मेट्रिक अब काम नहीं करती हैं.

18 जून, 2018

इस अपडेट में, YouTube Analytics (टारगेट की जाने वाली क्वेरी) API में ये बदलाव किए गए हैं:

इन तरीकों के लिए, स्कोप से जुड़ी ज़रूरी शर्तें बदल गई हैं:
- reports.query तरीके के अनुरोधों के पास, https://www.googleapis.com/auth/youtube.readonly स्कोप का ऐक्सेस होना चाहिए.
- groupItems.list तरीके के अनुरोधों के पास इनमें से किसी एक का ऐक्सेस होना चाहिए:
  - https://www.googleapis.com/auth/youtube स्कोप
    या
  - https://www.googleapis.com/auth/youtube.readonly स्कोप
    और
    https://www.googleapis.com/auth/yt-analytics.readonly स्कोप
  पहले विकल्प में एक स्कोप का इस्तेमाल किया जाता है, जो कि रीड-राइट स्कोप होता है. वहीं, दूसरे विकल्प में सिर्फ़ रीड-ओनली वाले दो स्कोप का इस्तेमाल किया जाता है.

23 मई, 2018

इस अपडेट में, YouTube Analytics (टारगेट की जाने वाली क्वेरी) API में ये बदलाव किए गए हैं:

एपीआई की खास जानकारी में एक नया सेक्शन, एग्रीगेट की गई मेट्रिक और मिटाए गए आइटम शामिल किया गया है. इसमें बताया गया है कि एपीआई से मिले जवाब, मिटाए गए संसाधनों से जुड़े डेटा को कैसे मैनेज करते हैं. जैसे, वीडियो, प्लेलिस्ट या चैनल.
एपीआई की खास जानकारी वाले सबसे सही तरीके सेक्शन को अपडेट किया गया है. इससे आपको यह याद रखने में मदद मिलेगी कि YouTube Analytics API से मिले जवाबों में पहचाने गए संसाधनों के लिए, अतिरिक्त मेटाडेटा पाने के लिए YouTube Data API का इस्तेमाल किया जा सकता है. YouTube API की सेवाओं के लिए डेवलपर की नीतियों (सेक्शन III.E.4.b से III.E.4.d तक) में बताया गया है कि एपीआई क्लाइंट को उस एपीआई से सेव किए गए संसाधन के मेटाडेटा को 30 दिनों के बाद मिटाना या रीफ़्रेश करना होगा.

22 मई, 2018

इस अपडेट में, YouTube Reporting (बल्क रिपोर्ट) API से जुड़े ये बदलाव शामिल हैं:

यहां दिए गए बदलाव, जुलाई 2018 से लागू होने वाले हैं. साथ ही, नई नीतियां दुनिया भर में सभी रिपोर्ट और रिपोर्टिंग जॉब पर लागू होंगी.
- इस बदलाव के बाद, ज़्यादातर एपीआई रिपोर्ट जनरेट होने के 60 दिनों तक उपलब्ध रहेंगी. इनमें बैकफ़िल रिपोर्ट भी शामिल हैं. हालांकि, पुराने डेटा वाली रिपोर्ट, जनरेट होने के बाद 30 दिनों तक उपलब्ध रहेंगी.
  
  इस एलान से पहले, सभी एपीआई रिपोर्ट जनरेट होने के बाद 180 दिनों तक उपलब्ध रहती थीं. साफ़ तौर पर बता दें कि नीति में यह बदलाव लागू होने के बाद, 30 दिन से ज़्यादा पुरानी रिपोर्ट को एपीआई के ज़रिए ऐक्सेस नहीं किया जा सकेगा. 60 दिन से ज़्यादा पुरानी अन्य रिपोर्ट भी ऐक्सेस नहीं की जा सकेंगी. इसलिए, दस्तावेज़ में अब यह बताया गया है कि नीति में बदलाव होने से पहले बनाई गई रिपोर्ट, 180 दिनों तक उपलब्ध रहेंगी.
- इस बदलाव के बाद, जब कोई रिपोर्टिंग जॉब शेड्यूल किया जाएगा, तो YouTube उस दिन से आगे की रिपोर्ट जनरेट करेगा. साथ ही, जॉब शेड्यूल किए जाने से पहले के 30 दिनों की रिपोर्ट भी जनरेट करेगा. इस बदलाव से पहले, रिपोर्टिंग जॉब शेड्यूल करने पर, YouTube उन रिपोर्ट को जनरेट करता था जिनमें जॉब शेड्यूल किए जाने से पहले के 180 दिनों का डेटा शामिल होता था.
सबसे सही तरीके सेक्शन को अपडेट किया गया है. इससे आपको यह याद रखने में मदद मिलेगी कि रिपोर्ट में मौजूद संसाधनों के लिए, अतिरिक्त मेटाडेटा पाने के लिए YouTube Data API का इस्तेमाल किया जा सकता है. YouTube API की सेवाओं के लिए डेवलपर की नीतियों (सेक्शन III.E.4.b से III.E.4.d तक) में बताया गया है कि एपीआई क्लाइंट को उस एपीआई से सेव किए गए संसाधन के मेटाडेटा को 30 दिनों के बाद मिटाना या रीफ़्रेश करना होगा.
रिपोर्ट की विशेषताएं सेक्शन को अपडेट किया गया है. इसमें बताया गया है कि भले ही रिपोर्ट के डेटा को फ़िल्टर न किया गया हो, लेकिन 1 जून, 2018 या उसके बाद की समयावधि का डेटा शामिल करने वाली रिपोर्ट में, YouTube के उन संसाधनों का कोई रेफ़रंस शामिल नहीं होगा जिन्हें रिपोर्ट जनरेट होने की तारीख से कम से कम 30 दिन पहले मिटा दिया गया था.
एपीआई की खास जानकारी वाले पेज पर, पुराने डेटा सेक्शन को अपडेट किया गया है. इसमें बताया गया है कि जब कोई नया रिपोर्टिंग जॉब शेड्यूल किया जाता है, तो पुराने डेटा की रिपोर्ट आम तौर पर कुछ दिनों में पोस्ट हो जाती हैं. पहले, दस्तावेज़ में बताया गया था कि ऐसी रिपोर्ट उपलब्ध होने में 30 दिन लग सकते हैं.
एपीआई की खास जानकारी के बैकफ़िल डेटा सेक्शन को अपडेट किया गया है. इससे बैकफ़िल डेटा को डेटा सेट के तौर पर ज़्यादा साफ़ तौर पर परिभाषित किया जा सकेगा. यह डेटा सेट, पहले से डिलीवर किए गए सेट की जगह लेता है.

26 अप्रैल, 2018

YouTube Analytics (टारगेट की जाने वाली क्वेरी) API का वर्शन 2 (v2) अब सार्वजनिक तौर पर उपलब्ध है. यहां दी गई सूची में, एपीआई के नए वर्शन से जुड़े प्रॉडक्ट और दस्तावेज़ में किए गए बदलावों के बारे में बताया गया है:

v2 API, काफ़ी हद तक v1 API जैसा ही है. हालांकि, आपको नीचे दिए गए बदलावों को लागू करने के लिए, अपने कोड को अपडेट करना पड़ सकता है. इन सभी बदलावों के बारे में, माइग्रेट करने से जुड़ी नई गाइड में विस्तार से बताया गया है.
- एपीआई का वर्शन v1 से बदलकर v2 हो गया है.
- एपीआई अनुरोधों के लिए बेस यूआरएल, https://www.googleapis.com/youtube/analytics/v1 से बदलकर https://youtubeanalytics.googleapis.com/v2 हो गया है.
- reports.query तरीके के कई पैरामीटर के नाम अपडेट किए गए हैं. खास तौर पर, v1 एपीआई में हाइफ़न वाले पैरामीटर के नाम, जैसे कि end-date, v2 एपीआई में हाइफ़न के बजाय कैमल केस (endDate) का इस्तेमाल करते हैं. इस बदलाव से, एपीआई में पैरामीटर के नाम एक जैसे हो जाते हैं. ऐसा इसलिए, क्योंकि ग्रुप बनाने और उन्हें मैनेज करने के लिए, एपीआई के तरीकों में पैरामीटर के नामों के लिए पहले से ही कैमल केस का इस्तेमाल किया जाता था.
- v2 API, Google के ग्लोबल एचटीटीपी बैच एंडपॉइंट (www.googleapis.com/batch) पर भेजे गए बैच अनुरोधों के साथ काम नहीं करता. अगर v2 API में बैच अनुरोध भेजे जा रहे हैं, तो आपको एंडपॉइंट https://youtubeanalytics.googleapis.com/v2 का इस्तेमाल करना होगा.
इसके अलावा, v1 की कुछ सुविधाएं v2 एपीआई में काम नहीं करती हैं:
- reports.query तरीके में अब alt, quotaUser, और userIp अनुरोध पैरामीटर काम नहीं करते.
- v2 API, ऐसा बैच एंडपॉइंट उपलब्ध नहीं कराता है जो अलग-अलग एपीआई के अनुरोधों वाले बैच के साथ काम करता हो. हालांकि, एक बैच में एक ही एपीआई के अलग-अलग तरीकों के अनुरोध शामिल हो सकते हैं. यह बदलाव सिर्फ़ YouTube Analytics API के लिए नहीं है. Google, अपने सभी एपीआई के लिए ग्लोबल बैच एंडपॉइंट को बंद कर रहा है.
- एपीआई के वर्शन 2 में JSON-RPC प्रोटोकॉल काम नहीं करता. हालांकि, यह एपीआई के वर्शन 1 में काम करता था. हम फिर से बता दें कि यह बदलाव सिर्फ़ YouTube Analytics API के लिए नहीं है.
ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

एपीआई का वर्शन 1 (v1) अब बंद कर दिया गया है. यह 31 अक्टूबर, 2018 तक काम करेगा. इस तारीख के बाद, v1 API से किया गया कोई भी अनुरोध स्वीकार नहीं किया जाएगा. इसलिए, कृपया 31 अक्टूबर, 2018 से पहले एपीआई के वर्शन 2 पर अपग्रेड कर लें. इससे एपीआई के ज़रिए YouTube Analytics का डेटा ऐक्सेस करने में कोई रुकावट नहीं आएगी.

21 फ़रवरी, 2018

इस अपडेट में, YouTube Analytics (टारगेट की जाने वाली क्वेरी) API में ये बदलाव किए गए हैं:

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

18 जनवरी, 2018

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Reporting API (बल्क रिपोर्ट)
- operating_system डाइमेंशन, उस डिवाइस के सॉफ़्टवेयर सिस्टम की पहचान करता है जिस पर वीडियो को व्यू मिले. अब इसमें यह वैल्यू इस्तेमाल की जा सकती है:
  - 25: KaiOS
YouTube Analytics API (टारगेट की जाने वाली क्वेरी)
- operatingSystem डाइमेंशन में, KAIOS डाइमेंशन वैल्यू का इस्तेमाल किया जा सकता है.

20 दिसंबर, 2017

इस अपडेट में, YouTube Reporting API से जुड़े दो बदलाव शामिल हैं:

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

gzip कोड में बदला गया जवाब पाने के लिए, Accept-Encoding एचटीटीपी अनुरोध हेडर को gzip पर सेट करें. इसके लिए, यहां दिया गया उदाहरण देखें:
```
Accept-Encoding: gzip
```
इस सुविधा के बारे में एपीआई की खास जानकारी और report संसाधन की downloadUrl प्रॉपर्टी की परिभाषा में बताया गया है.
age group और gender डाइमेंशन के दस्तावेज़ में सुधार किया गया है, ताकि उन डाइमेंशन के लिए एपीआई से मिलने वाली असल वैल्यू दिखाई जा सकें. ध्यान दें कि यह बदलाव सिर्फ़ दस्तावेज़ में किया गया है. इससे एपीआई के काम करने के तरीके या सुविधाओं में कोई बदलाव नहीं होगा. खास तौर पर, इन वैल्यू में बदलाव हुआ है:
- age_group डाइमेंशन की वैल्यू में, अंग्रेज़ी के बड़े अक्षरों का इस्तेमाल किया जाता है. साथ ही, AGE शब्द और उम्र समूह की संख्याओं के बीच अंडरस्कोर होते हैं. इसके अलावा, हाइफ़न के बजाय अंडरस्कोर का इस्तेमाल किया जाता है. इसलिए, age13-17 और age18-24 जैसी वैल्यू को बदलकर, क्रमशः AGE_13_17 और AGE_18_24 कर दिया गया है.
- gender डाइमेंशन की वैल्यू में अंग्रेज़ी के बड़े अक्षरों का इस्तेमाल किया जाता है. इसलिए, female, male, और gender_other वैल्यू को बदलकर FEMALE, MALE, और GENDER_OTHER कर दिया गया है.

10 अगस्त, 2017

इस दस्तावेज़ में 10 अगस्त, 2016 को YouTube Analytics API की earnings मेट्रिक के बंद होने की सूचना दी गई थी. (साथ ही, एपीआई में एक नई मेट्रिक जोड़ी गई है, जिसका नाम estimatedRevenue है. यह मेट्रिक भी वही डेटा उपलब्ध कराती है.)

earnings मेट्रिक एक मुख्य मेट्रिक थी. इसलिए, एलान की तारीख से एक साल तक इसका इस्तेमाल किया जा सकता था. हालांकि, अब एक साल की वह अवधि खत्म हो गई है. इसलिए, earnings मेट्रिक अब काम नहीं करती. इस वजह से, earnings मेट्रिक तय करने वाले एपीआई अनुरोधों से अब 400 एचटीटीपी रिस्पॉन्स कोड मिलता है. अगर आपने अब तक अपने ऐप्लिकेशन को earnings मेट्रिक के बजाय estimatedRevenue मेट्रिक का इस्तेमाल करने के लिए अपडेट नहीं किया है, तो कृपया जल्द से जल्द ऐसा करें.

एपीआई से जुड़े दस्तावेज़ को अपडेट कर दिया गया है, ताकि earnings मेट्रिक के बचे हुए रेफ़रंस हटाए जा सकें.

6 जुलाई, 2017

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Analytics API (टारगेट की जाने वाली क्वेरी)
- एपीआई के दस्तावेज़ को अपडेट कर दिया गया है. इससे पता चलता है कि एपीआई से मिली जानकारी में, अनुरोध की गई तारीख की सीमा के आखिरी दिन तक का डेटा शामिल होता है. इस डेटा में, क्वेरी की जा रही सभी मेट्रिक उपलब्ध होती हैं.
  
  उदाहरण के लिए, अगर किसी अनुरोध में खत्म होने की तारीख 5 जुलाई, 2017 बताई गई है और अनुरोध की गई सभी मेट्रिक की वैल्यू सिर्फ़ 3 जुलाई, 2017 तक उपलब्ध हैं, तो जवाब में शामिल डेटा की आखिरी तारीख 3 जुलाई, 2017 होगी. (यह तब भी सही है, जब अनुरोध की गई कुछ मेट्रिक का डेटा 4 जुलाई, 2017 के लिए उपलब्ध हो.)
- adType डाइमेंशन में अब reservedBumperInstream वैल्यू का इस्तेमाल किया जा सकता है. यह वैल्यू, स्किप न किए जा सकने वाले ऐसे वीडियो विज्ञापन को दिखाती है जो छह सेकंड तक चलता है और वीडियो शुरू होने से पहले दिखता है. विज्ञापन फ़ॉर्मैट, auctionBumperInstream विज्ञापन जैसा ही होता है. हालांकि, इस टाइप के विज्ञापन, नीलामी के बजाय रिज़र्वेशन के आधार पर बेचे जाते हैं.
YouTube Reporting API (बल्क रिपोर्ट)
- ad_type डाइमेंशन में अब 20 वैल्यू का इस्तेमाल किया जा सकता है. यह वैल्यू, रिज़र्वेशन के आधार पर बेचे जाने वाले बंपर विज्ञापनों के लिए इस्तेमाल की जाती है. बंपर विज्ञापन, स्किप न किए जा सकने वाले वीडियो विज्ञापन होते हैं. ये छह सेकंड तक के होते हैं. ये विज्ञापन किसी वीडियो से पहले चलते हैं. ध्यान दें कि इस डाइमेंशन के लिए वैल्यू 19, उन बंपर विज्ञापनों के बारे में भी बताती है जिन्हें रिज़र्वेशन के बजाय नीलामी के आधार पर बेचा जाता है.
- YouTube Reporting API की इन रिपोर्ट के लिए, रिपोर्टिंग जॉब मिटा दिए गए हैं:
  - channel_basic_a1
  - channel_province_a1
  - channel_playback_location_a1
  - channel_traffic_source_a1
  - channel_device_os_a1
  - channel_subtitles_a1
  - channel_combined_a1
  - content_owner_basic_a2
  - content_owner_province_a1
  - content_owner_playback_location_a1
  - content_owner_traffic_source_a1
  - content_owner_device_os_a1
  - content_owner_subtitles_a1
  - content_owner_combined_a1
  - content_owner_asset_basic_a1
  - content_owner_asset_province_a1
  - content_owner_asset_playback_location_a1
  - content_owner_asset_traffic_source_a1
  - content_owner_asset_device_os_a1
  - content_owner_asset_combined_a1
  इन रिपोर्ट टाइप को 15 सितंबर, 2016 को बंद कर दिया गया था. साथ ही, 15 दिसंबर, 2016 के बाद इन रिपोर्ट टाइप के लिए रिपोर्ट जनरेट नहीं की गईं. पहले जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहती थीं. इसलिए, कुछ रिपोर्ट 15 जून, 2017 तक ऐक्सेस की जा सकती थीं. हालांकि, रिपोर्ट अब उपलब्ध नहीं हैं. इसलिए, रिपोर्ट से जुड़े जॉब की भी ज़रूरत नहीं है.

24 मई, 2017

YouTube Reporting API की इन रिपोर्ट के लिए, सभी रिपोर्टिंग जॉब मिटा दिए गए हैं:

content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1

इन रिपोर्ट टाइप को 22 जून, 2016 को बंद कर दिया गया था. साथ ही, 22 सितंबर, 2016 के बाद इन रिपोर्ट टाइप के लिए रिपोर्ट जनरेट नहीं की गईं. पहले जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहती थीं. इसलिए, कुछ रिपोर्ट 22 मार्च, 2017 तक ऐक्सेस की जा सकती थीं. हालांकि, रिपोर्ट अब उपलब्ध नहीं हैं. इसलिए, रिपोर्ट से जुड़े जॉब की भी ज़रूरत नहीं है.

22 मई, 2017

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Reporting API (बल्क रिपोर्ट)
- sharing_service डाइमेंशन से, वीडियो शेयर करने के लिए इस्तेमाल की गई सेवा की पहचान की जाती है. अब इसमें ये वैल्यू इस्तेमाल की जा सकती हैं:
  - 85: YouTube Music
  - 86: YouTube Gaming
  - 87: YouTube Kids
  - 88: YouTube TV
  इसके अलावा, दस्तावेज़ में 52 वैल्यू की पहचान करने के लिए इस्तेमाल किए गए नाम को Kakao (Kakao Talk) में अपडेट कर दिया गया है. इससे, 73 (Kakao Story) वैल्यू से इसे साफ़ तौर पर अलग किया जा सकेगा. इस बदलाव से, एपीआई के काम करने के तरीके या इन सेवाओं के साथ शेयर किए गए वीडियो की कैटगरी में कोई बदलाव नहीं होता.
YouTube Analytics API (टारगेट की जाने वाली क्वेरी)
- sharingService डाइमेंशन में अब ये वैल्यू इस्तेमाल की जा सकती हैं:
  - YOUTUBE_GAMING
  - YOUTUBE_KIDS
  - YOUTUBE_MUSIC
  - YOUTUBE_TV

28 मार्च, 2017

चैनल के जिन मालिकों के पास Creator Studio में YouTube Analytics के ज़रिए रेवेन्यू का डेटा ऐक्सेस करने की अनुमति है वे अब YouTube Analytics API के ज़रिए भी रेवेन्यू का डेटा ऐक्सेस कर सकते हैं:

एपीआई में, रेवेन्यू से जुड़ी ये मेट्रिक काम करती हैं:
- adImpressions
- cpm
- estimatedAdRevenue
- estimatedRedPartnerRevenue
- estimatedRevenue
- grossRevenue
- monetizedPlaybacks
- playbackBasedCpm
इन मेट्रिक का इस्तेमाल, इन रिपोर्ट के लिए किया जा सकता है:
चैनल के मालिक अब विज्ञापन की परफ़ॉर्मेंस रिपोर्ट भी देख सकते हैं. इसमें adType डाइमेंशन के साथ-साथ, वैकल्पिक day डाइमेंशन भी शामिल होता है.
YouTube Analytics API के सैंपल अनुरोधों की गाइड में, अब चैनल के रेवेन्यू की रिपोर्ट के लिए एक सेक्शन शामिल है.

17 मार्च, 2017

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Analytics API, redViews और estimatedRedMinutesWatched मेट्रिक के साथ काम करता है. ये दोनों मेट्रिक, YouTube Red के दर्शकों की संख्या से जुड़ी हैं. दरअसल, एपीआई में ये मेट्रिक कुछ समय से काम कर रही हैं. साथ ही, YouTube Reporting API में ये दोनों मेट्रिक पहले से काम कर रही हैं. इस बारे में 15 सितंबर, 2016 को एलान किया गया था.
- redViews मेट्रिक से पता चलता है कि YouTube Red के सदस्यों ने किसी वीडियो को कितनी बार देखा.
- estimatedRedMinutesWatched मेट्रिक से पता चलता है कि YouTube Red के सदस्यों ने कितने मिनट तक वीडियो देखा.
चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट के दस्तावेज़ को अपडेट कर दिया गया है. इससे यह पता चलता है कि कौनसी रिपोर्ट, इन दो नई मेट्रिक के साथ काम करती हैं. ये उन सभी रिपोर्ट में काम करते हैं जिनमें views और estimatedMinutesWatched मेट्रिक पहले से काम करती हैं.

3 मार्च, 2017

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Reporting API (बल्क रिपोर्ट)
- date डाइमेंशन की परिभाषा में सुधार किया गया है. इससे पता चलता है कि डाइमेंशन वैल्यू, तय किए गए दिन, महीने, और साल को पैसिफ़िक समय के मुताबिक रात 12:00 बजे से शुरू होकर रात 11:59 बजे खत्म होने वाली अवधि के बारे में बताती है. साल के समय के हिसाब से, पैसिफ़िक टाइम यूटीसी-7 या यूटीसी-8 होता है.
  
  आम तौर पर, तारीखें 24 घंटे की अवधि को दिखाती हैं. हालांकि, जिन तारीखों पर घड़ियों को आगे सेट किया जाता है वे 23 घंटे की अवधि को दिखाती हैं. वहीं, जिन तारीखों पर घड़ियों को पीछे सेट किया जाता है वे 25 घंटे की अवधि को दिखाती हैं. (पहले, दस्तावेज़ में बताया गया था कि हर तारीख, 24 घंटे की एक यूनीक अवधि को दिखाती है और पैसिफ़िक टाइम हमेशा यूटीसी-8 होता है.)
  
  ध्यान दें कि इस सुधार से, एपीआई के असल व्यवहार में कोई बदलाव नहीं होता.
- operating_system डाइमेंशन, उस डिवाइस के सॉफ़्टवेयर सिस्टम की पहचान करता है जिस पर व्यू मिले. अब इसमें ये वैल्यू इस्तेमाल की जा सकती हैं:
  - 22: Tizen
  - 23: Firefox
  - 24: RealMedia
- content_owner_basic_a1 रिपोर्ट टाइप के लिए, सभी रिपोर्टिंग जॉब मिटा दिए गए हैं. इस तरह की रिपोर्ट को 19 अगस्त, 2016 से पूरी तरह से बंद कर दिया गया था. हालांकि, पहले जनरेट की गई content_owner_basic_a1 रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध थीं. इसलिए, कुछ रिपोर्ट 19 फ़रवरी, 2017 तक ऐक्सेस की जा सकती थीं. हालांकि, रिपोर्ट अब उपलब्ध नहीं हैं. इसलिए, रिपोर्ट से जुड़े जॉब की भी ज़रूरत नहीं है.
YouTube Analytics API (टारगेट की जाने वाली क्वेरी)
- time periods से जुड़े डाइमेंशन के ब्यौरे में सुधार किया गया है. इससे यह पता चलता है कि डाइमेंशन की वैल्यू, तय किए गए दिन, महीने, और साल को पैसिफ़िक समय के मुताबिक रात 12:00 बजे से शुरू होकर रात 11:59 बजे खत्म होने वाली अवधि के लिए है. साल के समय के हिसाब से, पैसिफ़िक टाइम यूटीसी-7 या यूटीसी-8 होता है.
  
  आम तौर पर, तारीखें 24 घंटे की अवधि को दिखाती हैं. हालांकि, जिन तारीखों पर घड़ियों को आगे सेट किया जाता है वे 23 घंटे की अवधि को दिखाती हैं. वहीं, जिन तारीखों पर घड़ियों को पीछे सेट किया जाता है वे 25 घंटे की अवधि को दिखाती हैं. (पहले, दस्तावेज़ में बताया गया था कि पैसिफ़िक टाइम यूटीसी-8 था. साथ ही, इसमें यह नहीं बताया गया था कि ऐसा हो सकता है कि एक दिन 24 घंटे का न हो.)
  
  ध्यान दें कि इस सुधार से, एपीआई के असल व्यवहार में कोई बदलाव नहीं होता.
- चैनल की रिपोर्ट के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि चैनल की रिपोर्ट में फ़िलहाल, आय या विज्ञापन की परफ़ॉर्मेंस मेट्रिक शामिल नहीं हैं. इस वजह से, https://www.googleapis.com/auth/yt-analytics-monetary.readonly स्कोप से फ़िलहाल चैनल की रिपोर्ट में कमाई से जुड़े डेटा का ऐक्सेस नहीं मिलता.
- operatingSystem डाइमेंशन में, डाइमेंशन की तीन नई वैल्यू इस्तेमाल की जा सकती हैं:
  - FIREFOX
  - REALMEDIA
  - TIZEN

8 फ़रवरी, 2017

YouTube Analytics API में अब वैकल्पिक include-historical-channel-data पैरामीटर का इस्तेमाल किया जा सकता है. ध्यान दें कि यह पैरामीटर सिर्फ़ तब काम का होता है, जब कॉन्टेंट के मालिक की रिपोर्ट को वापस लाया जा रहा हो.

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

अगर एपीआई अनुरोध से कई चैनलों का डेटा वापस मिलता है, तो ये नियम तब भी लागू होते हैं:

अगर पैरामीटर वैल्यू false है, तो किसी चैनल के लिए देखने का कुल समय और व्यू का डेटा, उस तारीख के हिसाब से दिखाया जाता है जिस दिन उस चैनल को कॉन्टेंट के मालिक से लिंक किया गया था.

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

15 दिसंबर, 2016

YouTube Reporting API की ये रिपोर्ट अब काम नहीं करती हैं. इसलिए, इन्हें दस्तावेज़ से हटा दिया गया है. हर रिपोर्ट का नया वर्शन उपलब्ध है. (इन रिपोर्ट को बंद करने का एलान 15 सितंबर, 2016 को किया गया था.)

चैनल की रिपोर्ट
- channel_basic_a1 - इसकी जगह channel_basic_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- channel_province_a1 - इसकी जगह channel_province_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- channel_playback_location_a1 - इसकी जगह channel_playback_location_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- channel_traffic_source_a1 - इसकी जगह channel_traffic_source_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- channel_device_os_a1 - इसकी जगह channel_device_os_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- channel_subtitles_a1 - इसकी जगह channel_subtitles_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- channel_combined_a1 - इसकी जगह channel_combined_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
कॉन्टेंट के मालिक के लिए रिपोर्ट
- content_owner_basic_a2 - इसकी जगह content_owner_basic_a3 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_province_a1 - इसकी जगह content_owner_province_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_playback_location_a1 - इसकी जगह content_owner_playback_location_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_traffic_source_a1 - इसकी जगह content_owner_traffic_source_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_device_os_a1 - इसकी जगह content_owner_device_os_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_subtitles_a1 - इसकी जगह content_owner_subtitles_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_combined_a1 - इसकी जगह content_owner_combined_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_asset_basic_a1 - इसकी जगह content_owner_asset_basic_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_asset_province_a1 - इसकी जगह content_owner_asset_province_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_asset_playback_location_a1 - इसकी जगह content_owner_asset_playback_location_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_asset_traffic_source_a1 - इसकी जगह content_owner_asset_traffic_source_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_asset_device_os_a1 - इसकी जगह content_owner_asset_device_os_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_asset_combined_a1 - इसकी जगह content_owner_asset_combined_a2 रिपोर्ट का इस्तेमाल किया जा सकता है.

एपीआई के रेफ़रंस दस्तावेज़ में, मौजूदा रिपोर्ट टाइप की सूची को भी अपडेट कर दिया गया है.

11 नवंबर, 2016

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Reporting API, एंड स्क्रीन की तीन नई रिपोर्ट के साथ-साथ उन रिपोर्ट के लिए नए डाइमेंशन और मेट्रिक के साथ काम करता है. इन रिपोर्ट में, वीडियो खत्म होने के बाद दिखने वाली एंड स्क्रीन के इंप्रेशन और क्लिक मिलने की दर (सीटीआर) के आंकड़े होते हैं.

एंड स्क्रीन की रिपोर्ट
- चैनल के वीडियो की एंड स्क्रीन रिपोर्ट में, चैनल के सभी वीडियो के आंकड़े शामिल होते हैं.
- कॉन्टेंट के मालिक के वीडियो की एंड स्क्रीन रिपोर्ट में, कॉन्टेंट के मालिक के किसी भी चैनल पर मौजूद वीडियो के आंकड़े शामिल होते हैं.
- कॉन्टेंट के मालिक की ऐसेट के लिए एंड स्क्रीन रिपोर्ट में, वीडियो से जुड़ी ऐसेट के आंकड़े होते हैं. इन वीडियो के बाद एंड स्क्रीन दिखती हैं.
एंड स्क्रीन के डाइमेंशन
- end_screen_element_type: आंकड़ों से जुड़े एंड स्क्रीन एलिमेंट का टाइप.
- end_screen_element_id: वह आईडी जिसका इस्तेमाल YouTube, एंड स्क्रीन एलिमेंट की खास तौर पर पहचान करने के लिए करता है.
एंड स्क्रीन की मेट्रिक

ध्यान दें: एंड स्क्रीन की मेट्रिक का डेटा, 1 मई, 2016 से उपलब्ध है.
- end_screen_element_impressions: एंड स्क्रीन एलिमेंट के इंप्रेशन की कुल संख्या. दिखने वाले हर एंड स्क्रीन एलिमेंट के लिए, एक इंप्रेशन लॉग किया जाता है.
- end_screen_element_clicks: एंड स्क्रीन पर मौजूद एलिमेंट पर कितनी बार क्लिक किया गया.
- end_screen_element_click_rate: एंड स्क्रीन के एलिमेंट पर क्लिक मिलने की दर.

YouTube सहायता केंद्र पर, वीडियो में एंड स्क्रीन जोड़ने के बारे में ज़्यादा जानकारी दी गई है.

ये रिपोर्ट अब काम नहीं करती हैं और इन्हें दस्तावेज़ से हटा दिया गया है. हर रिपोर्ट का नया वर्शन उपलब्ध है. (इन रिपोर्ट को बंद करने का एलान 22 जून, 2016 को किया गया था.)
- content_owner_ad_performance_a1 - इसकी जगह content_owner_ad_rates_a1 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_estimated_earnings_a1 - इसकी जगह content_owner_estimated_revenue_a1 रिपोर्ट का इस्तेमाल किया जा सकता है.
- content_owner_asset_estimated_earnings_a1 - इसकी जगह content_owner_asset_estimated_revenue_a1 रिपोर्ट का इस्तेमाल किया जा सकता है.

8 नवंबर, 2016

इस अपडेट में, YouTube Analytics API में ये बदलाव किए गए हैं:

यहां दी गई सूची में शामिल मेट्रिक अब पूरी तरह से बंद हो चुकी हैं और इनका इस्तेमाल नहीं किया जा सकता. जैसा कि 10 अगस्त, 2016 को एलान किया गया था, एक जैसे डेटा के लिए नई मेट्रिक पहले से ही काम कर रही हैं. नीचे दी गई टेबल में, बंद की गई मेट्रिक का नाम और नई मेट्रिक का नाम दिखाया गया है:

अब इस्तेमाल नहीं की जा रही मेट्रिक	नई मेट्रिक
`adEarnings`	`estimatedAdRevenue`
`impressionBasedCpm`	`cpm`
`impressions`	`adImpressions`
`redPartnerRevenue`	`estimatedRedPartnerRevenue`

27 अक्टूबर, 2016

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

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

reportType संसाधन की id प्रॉपर्टी को अपडेट कर दिया गया है, ताकि सिस्टम से मैनेज की जाने वाली उन रिपोर्ट की सूची शामिल की जा सके जिन्हें एपीआई के ज़रिए ऐक्सेस किया जा सकता है:

हर वीडियो के लिए, विज्ञापन से मिलने वाला हर महीने का रेवेन्यू (दुनिया भर में)
हर वीडियो के लिए, हर देश में विज्ञापन से मिलने वाला रोज़ का रेवेन्यू
हर ऐसेट के लिए, दुनिया भर में विज्ञापन से मिलने वाला हर महीने का रेवेन्यू
हर ऐसेट के लिए, हर देश में विज्ञापन से मिलने वाला रोज़ का रेवेन्यू
दावे (इस रिपोर्ट में रेवेन्यू का डेटा शामिल नहीं होता)

27 सितंबर, 2016

ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

YouTube Analytics API की uniques मेट्रिक को बंद कर दिया गया है. यह कोई कोर मेट्रिक नहीं है और इसे 31 अक्टूबर, 2016 तक ही इस्तेमाल किया जा सकेगा.

15 सितंबर, 2016

इस अपडेट में, YouTube Reporting API में किए गए ये बदलाव शामिल हैं:

एपीआई, YouTube Red के दर्शकों की संख्या से जुड़ी दो नई मेट्रिक के साथ काम करता है:
- red_views: YouTube Red के सदस्यों ने किसी वीडियो को कितनी बार देखा.
- red_watch_time_minutes: YouTube Red के सदस्यों ने वीडियो को कितने मिनट तक देखा.
एपीआई, 20 रिपोर्ट के नए वर्शन के साथ काम करता है. सभी नए वर्शन, नई red_views और red_watch_time_minutes मेट्रिक के साथ काम करते हैं.

हर रिपोर्ट के लिए, नए रिपोर्ट टाइप आईडी में मौजूद संख्या, पुराने रिपोर्ट टाइप आईडी में मौजूद संख्या से एक नंबर ज़्यादा होती है. इन रिपोर्ट के पुराने वर्शन अब काम नहीं करते. इस बारे में, बदलावों के इतिहास में आगे बताया गया है. उदाहरण के लिए, channel_basic_a1 रिपोर्ट अब काम नहीं करती. इसकी जगह channel_basic_a2 रिपोर्ट का इस्तेमाल किया जाता है.

यहां दी गई सूचियों में, रिपोर्ट टाइप के नए आईडी की जानकारी दी गई है:
- चैनल के वीडियो की रिपोर्ट
  - channel_basic_a2
  - channel_province_a2
  - channel_playback_location_a2
  - channel_traffic_source_a2
  - channel_device_os_a2
  - channel_subtitles_a2
  - channel_combined_a2
- कॉन्टेंट के मालिक के लिए वीडियो की रिपोर्ट
- कॉन्टेंट के मालिक के लिए ऐसेट रिपोर्ट
ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

ध्यान दें कि अगर आपके पास ऊपर दी गई रिपोर्ट के किसी भी पुराने वर्शन को बनाने के लिए पहले से ही जॉब मौजूद हैं, तो आपको नाम बदली गई रिपोर्ट के लिए नए जॉब बनाने होंगे. रिपोर्ट के नए वर्शन रिलीज़ होने के साथ-साथ, रिपोर्ट के ये वर्शन अब काम नहीं करेंगे:
- channel_basic_a1
- channel_province_a1
- channel_playback_location_a1
- channel_traffic_source_a1
- channel_device_os_a1
- channel_subtitles_a1
- channel_combined_a1
- content_owner_basic_a2
- content_owner_province_a1
- content_owner_playback_location_a1
- content_owner_traffic_source_a1
- content_owner_device_os_a1
- content_owner_subtitles_a1
- content_owner_combined_a1
- content_owner_asset_basic_a1
- content_owner_asset_province_a1
- content_owner_asset_playback_location_a1
- content_owner_asset_traffic_source_a1
- content_owner_asset_device_os_a1
- content_owner_asset_combined_a1
अगर आपके पास इनमें से किसी भी रिपोर्ट के लिए जॉब हैं, तो आपको यह उम्मीद नहीं करनी चाहिए कि YouTube, 15 दिसंबर, 2016 के बाद उन जॉब के लिए नई रिपोर्ट जनरेट करेगा. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहेंगी.

19 अगस्त, 2016

इस अपडेट में, YouTube Reporting API में किया गया यह बदलाव शामिल है:

content_owner_basic_a1 रिपोर्ट को पूरी तरह से बंद कर दिया गया है और दस्तावेज़ से हटा दिया गया है. YouTube अब उस तरह की नई रिपोर्ट जनरेट नहीं करेगा. हालांकि, पहले से जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहेंगी.

content_owner_basic_a1 रिपोर्ट की जगह content_owner_basic_a2 रिपोर्ट का इस्तेमाल किया जाता है. इसके बारे में 19 मई, 2016 की बदलावों के इतिहास की एंट्री में बताया गया है.

11 अगस्त, 2016

इस अपडेट में ये बदलाव शामिल हैं:

YouTube API की सेवाओं की शर्तों ("अपडेट की गई शर्तें") को हाल ही में पब्लिश किया गया है. इनके बारे में YouTube इंजीनियरिंग और डेवलपर ब्लॉग पर विस्तार से बताया गया है. इनमें, सेवा की मौजूदा शर्तों में किए गए कई अपडेट शामिल हैं. अपडेट की गई शर्तें 10 फ़रवरी, 2017 से लागू होंगी. इस अपडेट में, कई ऐसे दस्तावेज़ भी शामिल हैं जिनसे डेवलपर को उन नीतियों को समझने में मदद मिलेगी जिनका उन्हें पालन करना होगा.

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

10 अगस्त, 2016

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Analytics API (टारगेट की जाने वाली क्वेरी)

ध्यान दें: यह सूचना, हटाए गए टैग और एट्रिब्यूट के बारे में है.

यहां दी गई टेबल में मौजूद मेट्रिक को बंद किया जा रहा है. साथ ही, इसी डेटा के लिए नई मेट्रिक भी लॉन्च की जा रही हैं. इसका मतलब है कि पुरानी मेट्रिक के नाम बदले जा रहे हैं. हालांकि, YouTube Analytics API में दोनों मेट्रिक के नाम तब तक काम करेंगे, जब तक कि टेबल में दी गई तारीखों के हिसाब से उन्हें बंद नहीं कर दिया जाता.

मेट्रिक का पुराना नाम	मेट्रिक का नया नाम	सहायता मिलने की तारीख
`earnings`	`estimatedRevenue`	10 अगस्त, 2017
`adEarnings`	`estimatedAdRevenue`	4 नवंबर, 2016
`redPartnerRevenue`	`estimatedRedPartnerRevenue`	4 नवंबर, 2016
`impressionBasedCpm`	`cpm`	4 नवंबर, 2016
`impressions`	`adImpressions`	4 नवंबर, 2016

ध्यान दें कि earnings मेट्रिक एक मुख्य मेट्रिक थी. इसलिए, इस एलान की तारीख से एक साल तक इसका इस्तेमाल किया जा सकेगा. अन्य मेट्रिक, जो मुख्य मेट्रिक नहीं थीं, वे तीन महीने तक यानी 4 नवंबर, 2016 तक काम करेंगी.

उदाहरण के लिए, 4 नवंबर, 2016 तक एपीआई अनुरोध में impressionBasedCpm मेट्रिक, cpm मेट्रिक या दोनों को शामिल किया जा सकता है. हालांकि, इस तारीख के बाद सिर्फ़ cpm मेट्रिक का इस्तेमाल किया जा सकेगा.

insightTrafficSourceType डाइमेंशन में, डाइमेंशन की दो नई वैल्यू इस्तेमाल की जा सकती हैं:
- CAMPAIGN_CARD: यह ट्रैफ़िक सोर्स सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए उपलब्ध है. इससे पता चलता है कि व्यू, उपयोगकर्ता के अपलोड किए गए उन वीडियो से मिले हैं जिन पर दावा किया गया है. साथ ही, कॉन्टेंट के मालिक ने इन वीडियो का इस्तेमाल, देखे गए कॉन्टेंट का प्रमोशन करने के लिए किया है.
- END_SCREEN: यह डेटा, किसी दूसरे वीडियो की एंड स्क्रीन से मिले व्यू के बारे में जानकारी देता है.
दोनों नए ट्रैफ़िक सोर्स के लिए, traffic source detail रिपोर्ट भी देखी जा सकती है. दोनों मामलों में, insightTrafficSourceDetail डाइमेंशन उस वीडियो की पहचान करता है जिससे दर्शक को रेफ़र किया गया था.
adType डाइमेंशन में अब auctionBumperInstream वैल्यू का इस्तेमाल किया जा सकता है. यह वैल्यू, स्किप न किए जा सकने वाले ऐसे वीडियो विज्ञापन को दिखाती है जो छह सेकंड तक चलता है और वीडियो शुरू होने से पहले दिखता है.

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

18 जुलाई, 2016

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Analytics API (टारगेट की जाने वाली क्वेरी)
- इन चैनल रिपोर्ट के लिए, इस्तेमाल की जा सकने वाली मेट्रिक की सूचियों को अपडेट किया गया है, ताकि उनमें कार्ड मेट्रिक शामिल की जा सकें. इन रिपोर्ट में कार्ड मेट्रिक की सुविधा, 28 जून, 2016 को जोड़ी गई थी. उस तारीख के लिए बदलावों के इतिहास की एंट्री में, इस बदलाव के बारे में ज़्यादा जानकारी दी गई है. ये रिपोर्ट हैं:
  - अमेरिका के राज्यों में रहने वाले उपयोगकर्ताओं की गतिविधि के बारे में बुनियादी जानकारी
  - अमेरिका के राज्यों में, तय समयावधि के दौरान उपयोगकर्ता गतिविधि
  - प्रांत के हिसाब से उपयोगकर्ता गतिविधि
  - सदस्यता की स्थिति के हिसाब से उपयोगकर्ता गतिविधि
  - राज्यों के हिसाब से, सदस्यता की स्थिति के आधार पर उपयोगकर्ता गतिविधि
  - राज्य के हिसाब से सबसे ज़्यादा देखे गए वीडियो
  - सदस्यता लेने वाले या सदस्यता छोड़ने वाले दर्शकों के लिए सबसे लोकप्रिय वीडियो
- चैनल के लिए दर्शक बनाए रखने से जुड़ी रिपोर्ट और कॉन्टेंट के मालिक के लिए दर्शक बनाए रखने से जुड़ी रिपोर्ट, दोनों के लिए फ़िल्टर की सूचियों को ठीक कर दिया गया है. इससे यह पता चलता है कि video फ़िल्टर ज़रूरी है और group फ़िल्टर काम नहीं करता.
  
  पहले, दोनों रिपोर्ट के दस्तावेज़ों में गलत तरीके से बताया गया था कि रिपोर्ट को उन दो फ़िल्टर में से किसी एक का इस्तेमाल करके या किसी भी फ़िल्टर का इस्तेमाल न करके वापस पाया जा सकता है.
YouTube Reporting API (बल्क रिपोर्ट)
- एपीआई की खास जानकारी में, रिपोर्ट का डाउनलोड यूआरएल पाने का तरीका बताने वाले सेक्शन में सुधार किया गया है. इसमें बताया गया है कि YouTube, उन दिनों के लिए भी डाउनलोड की जा सकने वाली रिपोर्ट जनरेट करता है जिन दिनों का कोई डेटा उपलब्ध नहीं था. उन रिपोर्ट में हेडर लाइन होती है, लेकिन अतिरिक्त डेटा नहीं होता. यह जानकारी, 12 अप्रैल, 2016 को इसी दस्तावेज़ के रिपोर्ट की विशेषताएं सेक्शन में पहले ही अपडेट कर दी गई थी.
- content_owner_asset_cards_a1 रिपोर्ट में मौजूद डाइमेंशन की सूची को ठीक कर दिया गया है, ताकि यह पता चल सके कि रिपोर्ट में card_id डाइमेंशन का इस्तेमाल किया गया है. पहले, दस्तावेज़ में डाइमेंशन का नाम गलती से card_title के तौर पर दिखाया गया था.

28 जून, 2016

YouTube Analytics API के दस्तावेज़ को अपडेट किया गया है. इससे चैनल और कॉन्टेंट के मालिक की कई रिपोर्ट में, कार्ड मेट्रिक के लिए सहायता की जानकारी मिलती है. नई मेट्रिक ये हैं:

ये मेट्रिक, इन रिपोर्ट में उपलब्ध होती हैं:

बुनियादी आंकड़े(चैनल, कॉन्टेंट के मालिक)
समय के हिसाब से(चैनल, कॉन्टेंट के मालिक)
उपयोगकर्ता का देश/इलाका (चैनल, कॉन्टेंट के मालिक)
सदस्यता की स्थिति के हिसाब से उपयोगकर्ता गतिविधि (चैनल, कॉन्टेंट के मालिक)
सबसे लोकप्रिय वीडियो (चैनल, कॉन्टेंट के मालिक)

22 जून, 2016

इस अपडेट में, YouTube Reporting API में किए गए ये बदलाव शामिल हैं. पहला बदलाव, आम तौर पर एपीआई से जुड़ा है. बाकी बदलावों का असर सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट पर पड़ता है:

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

पहले, दस्तावेज़ में बताया गया था कि एपीआई अनुरोध भेजे जाने की तारीख से 180 दिन पहले तक की रिपोर्ट उपलब्ध होती हैं. हालांकि, तकनीकी तौर पर यह भी सही है, लेकिन ओरिजनल टेक्स्ट काफ़ी भ्रमित करने वाला था.
एपीआई, तीन रिपोर्ट के नए वर्शन के साथ काम करता है. इनमें से दो रिपोर्ट में नई और नाम बदली गई मेट्रिक भी शामिल हैं:
- content_owner_ad_rates_a1 रिपोर्ट, content_owner_ad_performance_a1 रिपोर्ट का नया वर्शन है. नए नाम वाली रिपोर्ट, पिछले वर्शन जैसी ही होती है.
- जिन दो रिपोर्ट के नए वर्शन उपलब्ध हैं उनके नाम बदल दिए गए हैं:
  - content_owner_estimated_earnings_a1 रिपोर्ट के नए वर्शन का नाम content_owner_estimated_revenue_a1 है.
  - content_owner_asset_estimated_earnings_a1 रिपोर्ट के नए वर्शन का नाम content_owner_asset_estimated_revenue_a1 है.
  दोनों रिपोर्ट के नाम बदल दिए गए हैं. ये रिपोर्ट, पहले की रिपोर्ट से इन तरीकों से अलग हैं:
  - वे नई estimated_partner_red_revenue मेट्रिक जोड़ते हैं. इससे YouTube Red की सदस्यताओं से होने वाली कुल कमाई का अनुमान लगाया जाता है.
  - वे नई estimated_partner_transaction_revenue मेट्रिक जोड़ते हैं. इससे लेन-देन से मिलने वाले अनुमानित रेवेन्यू का अनुमान लगाया जाता है. जैसे, पैसे चुकाकर देखे जाने वाले कॉन्टेंट और फ़ैन फ़ंडिंग से मिलने वाला रेवेन्यू. इसमें से पार्टनर को दिए जाने वाले रिफ़ंड घटा दिए जाते हैं.
  - वे estimated_partner_ad_sense_revenue मेट्रिक का नाम बदलकर estimated_partner_ad_auction_revenue कर देते हैं.
  - वे estimated_partner_double_click_revenue मेट्रिक का नाम बदलकर estimated_partner_ad_reserved_revenue कर देते हैं.
ध्यान दें कि अगर आपके पास इन रिपोर्ट के किसी भी पुराने वर्शन को बनाने के लिए पहले से ही जॉब मौजूद हैं, तो आपको नाम बदली गई रिपोर्ट के लिए नए जॉब बनाने होंगे. रिपोर्ट के नए वर्शन रिलीज़ होने के साथ ही, content_owner_ad_performance_a1, content_owner_estimated_earnings_a1, और content_owner_asset_estimated_earnings_a1 रिपोर्ट को बंद कर दिया गया है.

अगर आपके पास इनमें से किसी भी रिपोर्ट के लिए जॉब हैं, तो 22 सितंबर, 2016 के बाद YouTube उन जॉब के लिए नई रिपोर्ट जनरेट नहीं करेगा. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहेंगी.
reportType संसाधन की id प्रॉपर्टी की परिभाषा को अपडेट किया गया है, ताकि उपलब्ध रिपोर्ट के मौजूदा सेट को दिखाया जा सके.
दस्तावेज़ में दो मेट्रिक के नाम ठीक किए गए हैं, ताकि वे रिपोर्ट में दिखने वाले नामों से मैच हो सकें. यह सिर्फ़ दस्तावेज़ में किया गया बदलाव है. इससे रिपोर्ट के असल कॉन्टेंट में कोई बदलाव नहीं होता:
- estimated_partner_adsense_revenue मेट्रिक का नाम बदलकर estimated_partner_ad_sense_revenue कर दिया गया है. हालांकि, ध्यान दें कि यह मेट्रिक सिर्फ़ उन दो रिपोर्ट में दिखती है जिन्हें इस अपडेट के साथ बंद किया जा रहा है. जैसा कि ऊपर बताया गया है, उन रिपोर्ट के नए वर्शन में इस मेट्रिक का नाम बदलकर estimated_partner_ad_auction_revenue कर दिया गया है.
- estimated_partner_doubleclick_revenue मेट्रिक का नाम बदलकर estimated_partner_double_click_revenue कर दिया गया है. ध्यान दें कि यह मेट्रिक सिर्फ़ उन दो रिपोर्ट में दिखती है जिन्हें इस अपडेट के साथ बंद किया जा रहा है. जैसा कि ऊपर बताया गया है, उन रिपोर्ट के नए वर्शन में इस मेट्रिक का नाम बदलकर estimated_partner_ad_reserved_revenue कर दिया गया है.
Reporting API के लिए डाइमेंशन के दस्तावेज़ को अपडेट कर दिया गया है. अब इसमें elapsed_video_time_percentage और audience_retention_type प्रॉपर्टी शामिल नहीं हैं. फ़िलहाल, एपीआई के ज़रिए उपलब्ध किसी भी रिपोर्ट में इन डाइमेंशन का इस्तेमाल नहीं किया जा सकता.

19 मई, 2016

इस अपडेट में, YouTube Reporting API में किए गए ये बदलाव शामिल हैं:

एपीआई, कॉन्टेंट के मालिकों के लिए उपयोगकर्ता गतिविधि की रिपोर्ट के नए वर्शन के साथ काम करता है. नई रिपोर्ट के लिए, रिपोर्ट टाइप आईडी content_owner_basic_a2 है. रिपोर्ट के पिछले वर्शन, content_owner_basic_a1 के उलट, नया वर्शन likes और dislikes मेट्रिक के साथ काम करता है.

अगर आपके पास content_owner_basic_a1 रिपोर्ट बनाने के लिए पहले से ही कोई जॉब है, तो भी आपको content_owner_basic_a2 रिपोर्ट के लिए एक नई जॉब बनानी होगी. YouTube, कॉन्टेंट के मालिकों को रिपोर्ट के नए वर्शन पर अपने-आप माइग्रेट नहीं कर रहा है. इसके अलावा, रिपोर्ट का नया वर्शन जनरेट करने के लिए, अपने-आप कोई जॉब भी नहीं बना रहा है. कुछ मामलों में, किसी नई और अनचाही जॉब का दिखना, नुकसान पहुंचा सकने वाला बदलाव हो सकता है.

नई रिपोर्ट के रिलीज़ होने के साथ ही, content_owner_basic_a1 रिपोर्ट को अब इस्तेमाल नहीं किया जा सकता. अगर आपके पास उस रिपोर्ट के लिए कोई जॉब है, तो आपको 19 अगस्त, 2016 के बाद उस जॉब के लिए YouTube से नई रिपोर्ट जनरेट होने की उम्मीद नहीं करनी चाहिए. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहेंगी.
reportType, job, और report संसाधन, सभी एक नई प्रॉपर्टी के साथ काम करते हैं. इससे यह पता चलता है कि जुड़ा हुआ संसाधन, अब काम नहीं करने वाली रिपोर्ट टाइप को दिखाता है या नहीं:
- reportType संसाधन की deprecateTime प्रॉपर्टी से, रिपोर्ट टाइप के बंद होने की तारीख और समय का पता चलता है. इस प्रॉपर्टी में सिर्फ़ उन रिपोर्ट के लिए वैल्यू होती है जिन्हें बंद कर दिया गया है. साथ ही, यह वैल्यू उस तारीख को दिखाती है जब YouTube उस तरह की रिपोर्ट जनरेट करना बंद कर देगा.
  
  किसी रिपोर्ट टाइप को बंद करने का एलान करने के बाद, YouTube उस टाइप की रिपोर्ट को अगले तीन महीनों तक जनरेट करता है. उदाहरण के लिए, 19 मई, 2016 को हुए इस अपडेट में, content_owner_basic_a1 रिपोर्ट को बंद करने का एलान किया गया है. इसलिए, उस तरह की रिपोर्ट के लिए deprecateTime, 19 अगस्त, 2016 के बाद का समय तय करता है. इसके बाद, YouTube उस तरह की रिपोर्ट जनरेट करना बंद कर देगा.
- job संसाधन की expireTime प्रॉपर्टी से, नौकरी के विज्ञापन की समयसीमा खत्म होने की तारीख और समय का पता चलता है. इस प्रॉपर्टी की वैल्यू तब होती है, जब जॉब से जुड़ी रिपोर्ट टाइप को बंद कर दिया गया हो या जॉब के लिए जनरेट की गई रिपोर्ट को लंबे समय तक डाउनलोड न किया गया हो. इस तारीख के बाद, YouTube इस जॉब के लिए नई रिपोर्ट जनरेट नहीं करेगा.
- report संसाधन की jobExpireTime प्रॉपर्टी से, उस तारीख और समय का पता चलता है जब रिपोर्ट से जुड़ा जॉब खत्म हो गया था या खत्म हो जाएगा. इस प्रॉपर्टी में वही वैल्यू होती है जो job रिसॉर्स में expireTime प्रॉपर्टी की होती है. इसके बारे में इस सूची के पिछले आइटम में बताया गया है.
अगर आपने अब काम न करने वाली रिपोर्ट के लिए कोई जॉब बनाने की कोशिश की, तो jobs.create मेथड अब 400 एचटीटीपी रिस्पॉन्स कोड (Bad Request) दिखाता है. इसके अलावा, इस तरीके के दस्तावेज़ में अब कई अन्य वजहें बताई गई हैं जिनकी वजह से एपीआई अनुरोध पूरा नहीं हो पाता.

12 अप्रैल, 2016

इस अपडेट में ये बदलाव शामिल हैं. इन सभी बदलावों का असर सिर्फ़ YouTube Reporting API पर पड़ता है:

YouTube अब रिपोर्टिंग जॉब के पहली बार शेड्यूल किए जाने से पहले की 180 दिनों की अवधि का डेटा जनरेट करता है. पहले, Reporting API कोई पुराना डेटा नहीं देता था. यह बदलाव सभी जॉब पर लागू होगा. इनमें वे जॉब भी शामिल हैं जो इस एलान से पहले बनाई गई थीं.

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

ध्यान दें कि पुराना डेटा, 1 जुलाई, 2015 के बाद का ही उपलब्ध है. इस वजह से, 28 दिसंबर, 2015 से पहले बनाई गई जॉब के लिए, 180 दिनों से कम का पुराना डेटा उपलब्ध होगा.

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

सिस्टम से मैनेज की जाने वाली रिपोर्ट लॉन्च करने की तैयारी के लिए, एपीआई में ये बदलाव किए जा रहे हैं:
- job संसाधन की नई systemManaged प्रॉपर्टी से पता चलता है कि संसाधन, सिस्टम से मैनेज की जाने वाली रिपोर्ट जनरेट करने वाले किसी जॉब के बारे में बताता है या नहीं. YouTube, कॉन्टेंट के मालिकों के लिए सिस्टम से मैनेज की जाने वाली रिपोर्ट अपने-आप जनरेट करता है. कॉन्टेंट के मालिक, उन रिपोर्ट को बनाने वाले जॉब में बदलाव नहीं कर सकते या उन्हें मिटा नहीं सकते.
- jobs.list तरीके का नया includeSystemManaged पैरामीटर यह बताता है कि एपीआई से मिली जानकारी में, सिस्टम से मैनेज की जाने वाली रिपोर्ट के लिए जॉब शामिल होने चाहिए या नहीं. पैरामीटर की डिफ़ॉल्ट वैल्यू false है.
- jobs.reports.list तरीके के नए startTimeAtOrAfter पैरामीटर से पता चलता है कि एपीआई से मिली जानकारी में सिर्फ़ वे रिपोर्ट शामिल होनी चाहिए जिनमें मौजूद सबसे पुराना डेटा, तय की गई तारीख या उसके बाद का हो. इसी तरह, startTimeBefore पैरामीटर से पता चलता है कि एपीआई से मिली जानकारी में रिपोर्ट सिर्फ़ तब शामिल होनी चाहिए, जब रिपोर्ट में मौजूद सबसे पुराना डेटा, तय की गई तारीख से पहले का हो.
  
  इस तरीके के createdAfter पैरामीटर से पता चलता है कि रिपोर्ट कब बनाई गई थी. हालांकि, नए पैरामीटर से रिपोर्ट में मौजूद डेटा के बारे में पता चलता है.
- reportType संसाधन की नई systemManaged प्रॉपर्टी से पता चलता है कि संसाधन, सिस्टम से मैनेज की जाने वाली रिपोर्ट के बारे में बताता है या नहीं.
- reportTypes.list तरीके का नया includeSystemManaged पैरामीटर यह बताता है कि एपीआई से मिली जानकारी में, सिस्टम से मैनेज की जाने वाली रिपोर्ट शामिल होनी चाहिए या नहीं. पैरामीटर की डिफ़ॉल्ट वैल्यू false है.

28 मार्च, 2016

YouTube Reporting API और YouTube Analytics API, अब शेयर करने की कई अन्य सेवाओं के लिए, व्यू के आंकड़े दिखाते हैं.

YouTube Reporting API में, sharing_service डाइमेंशन के लिए ये नई वैल्यू इस्तेमाल की जा सकती हैं:
- 82: iOS सिस्टम ऐक्टिविटी डायलॉग
- 83: Google Inbox
- 84: Android Messenger
YouTube Analytics API में, sharingService डाइमेंशन के लिए ये नई वैल्यू इस्तेमाल की जा सकती हैं:
- ANDROID_MESSENGER: Android Messenger
- INBOX: Google Inbox
- IOS_SYSTEM_ACTIVITY_DIALOG: iOS सिस्टम ऐक्टिविटी डायलॉग

16 मार्च, 2016

इस अपडेट में ये बदलाव शामिल हैं. इनका असर, YouTube Reporting API और YouTube Analytics API, दोनों पर पड़ता है:

YouTube Reporting API

playback_location_type डाइमेंशन में, डाइमेंशन की दो नई वैल्यू इस्तेमाल की जा सकती हैं:
- 7: यह डेटा, YouTube के होम पेज या होम स्क्रीन, उपयोगकर्ता के सदस्यता फ़ीड या YouTube की किसी अन्य ब्राउज़िंग सुविधा पर मिले व्यू से जुड़ा होता है.
- 8: यह डेटा उन व्यू के बारे में है जो सीधे तौर पर YouTube के खोज नतीजों वाले पेज से मिले हैं.
traffic_source_type डाइमेंशन में अब 18 को डाइमेंशन वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इस वैल्यू से पता चलता है कि वीडियो को मिले व्यू, किसी ऐसे पेज से मिले हैं जिसमें प्लेलिस्ट के सभी वीडियो की सूची मौजूद है. यह सोर्स, सोर्स टाइप 14 से अलग है. इससे पता चलता है कि वीडियो को प्लेलिस्ट के हिस्से के तौर पर चलाए जाने के दौरान व्यू मिले.

YouTube Analytics API

insightPlaybackLocationType डाइमेंशन में, डाइमेंशन की दो नई वैल्यू इस्तेमाल की जा सकती हैं:
- BROWSE: यह डेटा, YouTube के होम पेज या होम स्क्रीन, उपयोगकर्ता के सदस्यता फ़ीड या YouTube की किसी अन्य ब्राउज़िंग सुविधा पर मिले व्यू से जुड़ा होता है.
- SEARCH: यह डेटा उन व्यू के बारे में है जो सीधे तौर पर YouTube के खोज नतीजों वाले पेज से मिले हैं.
insightTrafficSourceType डाइमेंशन में अब YT_PLAYLIST_PAGE को डाइमेंशन वैल्यू के तौर पर इस्तेमाल किया जा सकता है. इस वैल्यू से पता चलता है कि वीडियो को मिले व्यू, किसी ऐसे पेज से मिले हैं जिसमें प्लेलिस्ट के सभी वीडियो की सूची मौजूद है. यह सोर्स, PLAYLIST सोर्स टाइप से अलग है. इससे पता चलता है कि व्यू तब मिले, जब वीडियो को प्लेलिस्ट के हिस्से के तौर पर चलाया गया था.

8 फ़रवरी, 2016

YouTube Analytics API के साथ काम करने वाली मेट्रिक की सूची को अपडेट कर दिया गया है. अब कार्ड मेट्रिक, इस एपीआई के साथ काम करने वाली मेट्रिक के तौर पर नहीं दिखेंगी. (एपीआई की किसी भी रिपोर्ट में, कार्ड की किसी भी मेट्रिक के साथ काम करने के बारे में जानकारी नहीं दी गई थी.)

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

6 जनवरी, 2016

YouTube Reporting API और YouTube Analytics API, दोनों अब खास तौर पर उन व्यू की पहचान करते हैं जो Chromecast डिवाइस से मिलते हैं.

YouTube Reporting API में, operating_system डाइमेंशन, 21 वैल्यू का इस्तेमाल करके उन व्यू की पहचान करता है जो Chromecast के ज़रिए मिले हैं.
YouTube Analytics API में, operatingSystem डाइमेंशन, CHROMECAST वैल्यू का इस्तेमाल करके उन व्यू की पहचान करता है जो Chromecast के ज़रिए मिलते हैं.

21 दिसंबर, 2015

दस्तावेज़ में, annotation_clickable_impressions और annotation_closable_impressions मेट्रिक के नाम अपडेट कर दिए गए हैं, ताकि वे रिपोर्ट में दिखाए जा रहे नामों से मैच कर सकें. पहले, नामों को clickable_annotation_impressions और closable_annotation_impressions के तौर पर दस्तावेज़ में दर्ज किया गया था.

18 दिसंबर, 2015

यूरोपियन यूनियन (ईयू) के कानूनों के मुताबिक, ईयू में रहने वाले असली उपयोगकर्ताओं को कुछ जानकारी देना और उनसे सहमति लेना ज़रूरी है. इसलिए, यूरोपियन यूनियन में रहने वाले असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने इस ज़रूरी शर्त की सूचना, YouTube API की सेवा की शर्तों में जोड़ दी है.

15 दिसंबर, 2015

इस अपडेट में ये बदलाव शामिल हैं. इन सभी का असर YouTube Analytics API पर पड़ता है:

YouTube Analytics API में अब तीन नए प्लेबैक डाइमेंशन इस्तेमाल किए जा सकते हैं. इनका इस्तेमाल, चैनल और कॉन्टेंट के मालिक की अलग-अलग रिपोर्ट में किया जा सकता है:
- liveOrOnDemand: इस डाइमेंशन से पता चलता है कि रिपोर्ट में मौजूद डेटा, लाइव ब्रॉडकास्ट के दौरान हुई उपयोगकर्ता गतिविधि के बारे में बताता है या नहीं.
- subscribedStatus: इस डाइमेंशन से पता चलता है कि डेटा में मौजूद उपयोगकर्ता गतिविधि की मेट्रिक, वीडियो या प्लेलिस्ट के चैनल की सदस्यता लेने वाले दर्शकों से जुड़ी हैं या नहीं.
- youtubeProduct: इस डाइमेंशन से, YouTube की उस प्रॉपर्टी की पहचान होती है जिस पर उपयोगकर्ता गतिविधि हुई. संभावित वैल्यू में YouTube की मुख्य वेबसाइट (या YouTube ऐप्लिकेशन), YouTube Gaming, और YouTube Kids शामिल हैं.
दस्तावेज़ को अपडेट कर दिया गया है, ताकि चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध, वीडियो चलाने की जानकारी देने वाली नई रिपोर्ट की पहचान की जा सके. इसके अलावा, कई अन्य रिपोर्ट को अपडेट किया गया है. इससे यह पता चलता है कि इनमें से एक या उससे ज़्यादा डाइमेंशन को उन रिपोर्ट में डाइमेंशन और/या फ़िल्टर के तौर पर इस्तेमाल किया जा सकता है.

रिपोर्ट के बारे में जानकारी देने वाली टेबल का फ़ॉर्मैट बदल गया है. इससे आपको डाइमेंशन, मेट्रिक, और फ़िल्टर के मान्य कॉम्बिनेशन की पहचान करने में आसानी होगी. इनका इस्तेमाल करके, हर रिपोर्ट को वापस पाया जा सकता है. यहां दी गई टेबल में, चैनलों के लिए "डिवाइस टाइप" रिपोर्ट के बारे में बताया गया है. इसमें नया फ़ॉर्मैट दिखाया गया है:

प्रॉपर्टी

वैल्यू

डाइमेंशन:

ज़रूरी है	deviceType
0 या इससे ज़्यादा का इस्तेमाल करें	day, liveOrOnDemand, subscribedStatus, youtubeProduct

मेट्रिक

एक या इससे ज़्यादा इस्तेमाल करें

views, estimatedMinutesWatched

छनक:

0 या 1 का इस्तेमाल करें	country, province, continent, subContinent
0 या 1 का इस्तेमाल करें	video, group
0 या इससे ज़्यादा का इस्तेमाल करें	operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

चैनल और कॉन्टेंट के मालिक की रिपोर्ट के दस्तावेज़ में, ज़रूरी और वैकल्पिक फ़ील्ड के बारे में बताया गया है.

YouTube Analytics API अब उन इकाइयों को अपने-आप हटा देता है जिनके लिए एपीआई का इस्तेमाल करने वाला व्यक्ति, एक से ज़्यादा वैल्यू (video, playlist, और channel) के साथ काम करने वाले फ़िल्टर से डेटा वापस नहीं पा सकता. पहले, अगर एपीआई का इस्तेमाल करने वाला व्यक्ति, तय किए गए आइटम में से कम से कम एक आइटम का डेटा ऐक्सेस नहीं कर पाता था, तो एपीआई सर्वर सिर्फ़ गड़बड़ी का मैसेज दिखाता था.

उदाहरण के लिए, मान लें कि कोई उपयोगकर्ता एपीआई अनुरोध सबमिट करता है, जिसमें video फ़िल्टर में 20 वीडियो आईडी की सूची है. उपयोगकर्ता के पास 18 वीडियो हैं. हालांकि, एक वीडियो का आईडी किसी दूसरे चैनल के मालिकाना हक वाले वीडियो की पहचान करता है. वहीं, दूसरा आईडी किसी ऐसे वीडियो की पहचान करता है जिसे मिटा दिया गया है. इसलिए, वह अब मौजूद नहीं है. इस मामले में, एपीआई सर्वर अब गड़बड़ी का मैसेज दिखाने के बजाय, उन दो वीडियो को हटा देता है जिन्हें उपयोगकर्ता ऐक्सेस नहीं कर सकता. साथ ही, एपीआई से मिली जानकारी में उन 18 वीडियो का डेटा शामिल होता है जिनका मालिकाना हक एपीआई उपयोगकर्ता के पास है.
अगर आपने YouTube Analytics group के लिए डेटा का अनुरोध किया है, जिसमें कोई डेटा मौजूद नहीं है, तो एपीआई अब गड़बड़ी का मैसेज दिखाने के बजाय, खाली डेटा सेट दिखाता है.
अगर किसी ग्रुप में कोई ऐसी इकाई जोड़ने की कोशिश की जाती है जिसका ऐक्सेस आपके पास नहीं है, तो YouTube Analytics API का groupItems.insert तरीका अब अनुमति न होने (403 एचटीटीपी रिस्पॉन्स कोड) की गड़बड़ी दिखाता है. पहले, एपीआई आपको ग्रुप में इकाई जोड़ने की अनुमति देता था. हालांकि, जब आपने उस ग्रुप के लिए रिपोर्ट डेटा को वापस पाने की कोशिश की, तो आपको अनुमति न होने की गड़बड़ी का मैसेज मिला.
YouTube Analytics API के groups.list तरीके में अब पेज नंबर डालने की सुविधा उपलब्ध है. अगर एपीआई से मिली जानकारी में सभी उपलब्ध ग्रुप शामिल नहीं हैं, तो रिस्पॉन्स का nextPageToken पैरामीटर एक टोकन तय करता है. इसका इस्तेमाल, नतीजों के अगले पेज को वापस पाने के लिए किया जा सकता है. ज़्यादा नतीजे पाने के लिए, तरीके के pageToken पैरामीटर को उस वैल्यू पर सेट करें.

10 नवंबर, 2015

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Analytics API में अब redPartnerRevenue मेट्रिक का इस्तेमाल किया जा सकता है. इससे, रिपोर्ट के लिए चुने गए डाइमेंशन के लिए, YouTube Red की सदस्यताओं से मिले कुल अनुमानित रेवेन्यू की जानकारी मिलती है. इस मेट्रिक की वैल्यू से, संगीत और संगीत से अलग कॉन्टेंट, दोनों से होने वाली आय का पता चलता है. महीने के आखिर में इसमें बदलाव हो सकता है.

YouTube Analytics API की कॉन्टेंट के मालिक की रिपोर्ट की सूची को अपडेट किया गया है, ताकि redPartnerRevenue मेट्रिक के साथ काम करने वाली वीडियो रिपोर्ट की पहचान की जा सके:
- बुनियादी आंकड़े
- समय के हिसाब से
- उपयोगकर्ता का देश या इलाका
- सबसे लोकप्रिय वीडियो – इस रिपोर्ट के लिए, redPartnerRevenue का इस्तेमाल भी क्रम से लगाने वाली मेट्रिक के तौर पर किया जा सकता है. इसका मतलब है कि YouTube Red से होने वाली कमाई के हिसाब से, वीडियो की सूची को क्रम से लगाया जा सकता है.
YouTube Analytics API के लिए, सबसे लोकप्रिय वीडियो की रिपोर्ट की परिभाषा में अब यह जानकारी शामिल है कि इस रिपोर्ट में कमाई से जुड़ी ये मेट्रिक भी दिखती हैं: earnings, adEarnings, grossRevenue, monetizedPlaybacks, playbackBasedCpm, impressions, और impressionBasedCpm.

29 अक्टूबर, 2015

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Reporting API के date डाइमेंशन के दस्तावेज़ में सुधार किया गया है. इससे पता चलता है कि तारीखें, पैसिफ़िक समय (यूटीसी-8) के हिसाब से रात 12:00 बजे से शुरू होने वाली 24 घंटे की अवधि को दिखाती हैं. पहले, दस्तावेज़ में बताया गया था कि तारीख रात 12:00 बजे (जीएमटी) से शुरू होती है.

इसके अलावा, YouTube Analytics API के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि तारीख से जुड़े सभी डाइमेंशन (day, 7DayTotals, 30DayTotals, और month), पैसिफ़िक समय (यूटीसी-8) के मुताबिक रात 12:00 बजे से शुरू होने वाली तारीखों के हिसाब से होते हैं.
YouTube Reporting API का jobs.reports.list() तरीका, अब createdAfter क्वेरी पैरामीटर के साथ काम करता है. अगर यह पैरामीटर तय किया गया है, तो इससे पता चलता है कि एपीआई से मिली जानकारी में सिर्फ़ तय की गई तारीख और समय के बाद बनाई गई रिपोर्ट शामिल होनी चाहिए. इसमें बैकफ़िल किए गए डेटा वाली नई रिपोर्ट भी शामिल हैं. ध्यान दें कि पैरामीटर वैल्यू, रिपोर्ट बनाने के समय से जुड़ी होती है, न कि दिखाए गए डेटा से जुड़ी तारीखों से.

पैरामीटर वैल्यू, RFC3339 यूटीसी "ज़ूलू" फ़ॉर्मैट में एक टाइमस्टैंप है. यह माइक्रोसेकंड तक सटीक होती है. उदाहरण: "2015-10-02T15:01:23.045678Z".

YouTube Reporting API के सबसे सही तरीकों को भी अपडेट किया गया है. इससे यह जानकारी मिलती है कि एक ही रिपोर्ट को बार-बार प्रोसेस करने से बचने के लिए, createdAfter पैरामीटर का इस्तेमाल कैसे किया जा सकता है.
job रिसॉर्स की createTime प्रॉपर्टी और report रिसॉर्स की startTime, endTime, और createTime प्रॉपर्टी की परिभाषाओं में सुधार किया गया है. अब प्रॉपर्टी की वैल्यू, नैनोसेकंड के बजाय माइक्रोसेकंड के हिसाब से सटीक हैं. इसके अलावा, सभी परिभाषाएं अब सटीक तौर पर बताती हैं कि प्रॉपर्टी की वैल्यू एक टाइमस्टैंप है.

8 अक्टूबर, 2015

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Analytics API के sharingService डाइमेंशन के दस्तावेज़ को अपडेट किया गया है, ताकि इसमें डाइमेंशन की संभावित वैल्यू की सूची शामिल की जा सके. इस सूची में, नई जोड़ी गई कई सेवाएं शामिल हैं.

YouTube Reporting API के sharing_service डाइमेंशन की परिभाषा को भी अपडेट किया गया है, ताकि इस्तेमाल की जा सकने वाली नई वैल्यू को लिस्ट किया जा सके. 59 से ज़्यादा enum वैल्यू, सूची में नई वैल्यू हैं.

24 सितंबर, 2015

इस अपडेट में ये बदलाव शामिल हैं:

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

YouTube Reporting API की हर रिपोर्ट में, डाइमेंशन और मेट्रिक का पहले से तय सेट होता है. (YouTube Analytics API की रिपोर्ट में भी मेट्रिक और डाइमेंशन का इस्तेमाल किया जाता है.) किसी रिपोर्ट में, डेटा की हर लाइन में डाइमेंशन वैल्यू का एक यूनीक कॉम्बिनेशन होता है. डाइमेंशन वैल्यू के आधार पर, अलग-अलग लाइनों में मौजूद डेटा को एग्रीगेट किया जा सकता है. इससे अलग-अलग वीडियो, देशों, लाइव वीडियो, सदस्यता लेने वाले उपयोगकर्ताओं वगैरह के लिए मेट्रिक का हिसाब लगाया जा सकता है.

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

20 अगस्त, 2015

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई से जुड़े दस्तावेज़ को फिर से तैयार किया गया है, ताकि एपीआई को आसानी से समझा जा सके. इन बदलावों से नई सुविधाओं के बारे में पता नहीं चलता:
- दस्तावेज़ में अब एक पेज पर, उपलब्ध सभी चैनल रिपोर्ट की सूची होती है. वहीं, दूसरे पेज पर, उपलब्ध सभी कॉन्टेंट के मालिक की रिपोर्ट की सूची होती है. पहले, दस्तावेज़ में चैनल के वीडियो की रिपोर्ट, चैनल की प्लेलिस्ट की रिपोर्ट वगैरह के लिए अलग-अलग पेज होते थे.
- डेटा मॉडल की खास जानकारी वाले नए पेज पर, एपीआई के काम करने के तरीके के बारे में साफ़ तौर पर बताया गया है. खास तौर पर, इस दस्तावेज़ में यह समझाने की कोशिश की गई है कि YouTube, रिपोर्ट की वैल्यू का हिसाब लगाने के लिए मेट्रिक, डाइमेंशन, और फ़िल्टर का इस्तेमाल कैसे करता है.
- एपीआई के reports.query तरीके का इस्तेमाल करके, रिपोर्ट वापस पाई जा सकती हैं. अब इस तरीके को अलग से दस्तावेज़ में शामिल किया गया है. उस पेज पर मौजूद जानकारी पहले कुछ अन्य पेजों पर थी. नए पेज को इस तरह से डिज़ाइन किया गया है कि आपको रिपोर्ट पाने के लिए ज़रूरी जानकारी को आसानी से पहचानने में मदद मिले.

22 जुलाई, 2015

इस अपडेट में कई बदलाव शामिल हैं. ये सभी बदलाव सिर्फ़ कॉन्टेंट के मालिकों पर लागू होते हैं:

नई adEarnings मेट्रिक में, Google के बेचे गए सभी विज्ञापन स्रोतों से होने वाली कुल अनुमानित आय (कुल आय) शामिल होती है. यह कोई मुख्य मेट्रिक नहीं है. एपीआई, adEarnings मेट्रिक के साथ काम करता है. यह ऐसी किसी भी रिपोर्ट के लिए काम करता है जिसमें earnings मेट्रिक पहले से काम करती है.

इसके अलावा, earnings मेट्रिक की परिभाषा में सुधार किया गया है. इससे यह पता चलता है कि इसकी वैल्यू में, Google के बेचे गए सभी विज्ञापन स्रोतों के साथ-साथ विज्ञापन के अलावा अन्य स्रोतों से होने वाली कुल अनुमानित आय शामिल है. पहले, परिभाषा में गलती से यह बताया गया था कि मेट्रिक में सिर्फ़ विज्ञापन स्रोतों से होने वाली आय शामिल है.
primaryAdGrossRevenue मेट्रिक का इस्तेमाल बंद कर दिया गया है. इसके बजाय, रेवेन्यू का डेटा पाने के लिए grossRevenue मेट्रिक का इस्तेमाल करें.
विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में, अब primaryAdGrossRevenue मेट्रिक के साथ-साथ monetizedPlaybacks और playbackBasedCpm मेट्रिक भी काम नहीं करतीं. हालांकि, कई वीडियो रिपोर्ट में अब भी ये मेट्रिक काम करती हैं.

1 जून, 2015

इस अपडेट में ये बदलाव शामिल हैं:

अब एपीआई में, वीडियो रिपोर्ट के लिए दो नई मेट्रिक इस्तेमाल की जा सकती हैं: videosAddedToPlaylists और videosRemovedFromPlaylists. चैनलों और कॉन्टेंट के मालिकों के लिए, वीडियो रिपोर्ट की सूचियों को अपडेट कर दिया गया है. इससे उन रिपोर्ट की पहचान की जा सकेगी जिनमें नई मेट्रिक का इस्तेमाल किया जा सकता है.
- videosAddedToPlaylists – इससे पता चलता है कि क्वेरी के दायरे में आने वाले वीडियो, YouTube की किसी प्लेलिस्ट में कितनी बार जोड़े गए. वीडियो को वीडियो के मालिक की प्लेलिस्ट या अन्य चैनलों की प्लेलिस्ट में जोड़ा गया हो.
- videosRemovedFromPlaylists – क्वेरी के दायरे में आने वाले वीडियो को YouTube की किसी प्लेलिस्ट से कितनी बार हटाया गया. ऐसा हो सकता है कि वीडियो के मालिक की प्लेलिस्ट या अन्य चैनलों की प्लेलिस्ट से वीडियो हटा दिए गए हों.
दोनों मेट्रिक में, "बाद में देखें" जैसी डिफ़ॉल्ट प्लेलिस्ट शामिल होती हैं. हालांकि, इनमें ऐसी प्लेलिस्ट शामिल नहीं होती हैं जिनमें वीडियो अपने-आप जुड़ जाता है. जैसे, किसी चैनल की अपलोड की गई प्लेलिस्ट या किसी उपयोगकर्ता का वीडियो देखने का इतिहास. यह भी ध्यान रखें कि ये मेट्रिक, जोड़े गए और मिटाए गए कीवर्ड की कुल संख्या दिखाती हैं. इसलिए, अगर कोई उपयोगकर्ता किसी वीडियो को प्लेलिस्ट में जोड़ता है, फिर उसे हटाता है, और फिर से जोड़ता है, तो मेट्रिक से पता चलता है कि वीडियो को दो प्लेलिस्ट में जोड़ा गया और एक से हटाया गया.

इन मेट्रिक का डेटा, 1 अक्टूबर, 2014 से उपलब्ध है.

31 मार्च, 2015

इस अपडेट में ये बदलाव शामिल हैं:

इस एलान के बाद, favoritesAdded और favoritesRemoved मेट्रिक का इस्तेमाल नहीं किया जा सकेगा. ये दोनों मुख्य मेट्रिक हैं. इन पर, सेवा की शर्तों में बताई गई, समर्थन नहीं होने की नीति लागू होती है.

16 मार्च, 2015

इस अपडेट में ये बदलाव शामिल हैं:

नए currency पैरामीटर की मदद से, डॉलर (USD) के अलावा किसी दूसरी मुद्रा में कमाई की मेट्रिक देखी जा सकती हैं. अगर पैरामीटर सेट है, तो एपीआई earnings, grossRevenue, playbackBasedCpm, और impressionBasedCpm मेट्रिक की वैल्यू को तय की गई मुद्रा में बदल देता है. दिखाई गई वैल्यू, रोज़ाना बदलने वाली एक्सचेंज रेट का इस्तेमाल करके कैलकुलेट किए गए अनुमान हैं.

पैरामीटर वैल्यू, तीन अक्षर वाला आईएसओ 4217 करंसी कोड होता है. डिफ़ॉल्ट वैल्यूUSD है पैरामीटर की परिभाषा में, इस्तेमाल किए जा सकने वाले करंसी कोड की सूची शामिल होती है.

25 फ़रवरी, 2015

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई की मदद से, अब YouTube Analytics ग्रुप बनाए और मैनेज किए जा सकते हैं. साथ ही, उन ग्रुप के लिए रिपोर्टिंग डेटा भी वापस पाया जा सकता है.
- ग्रुप बनाना और उन्हें मैनेज करना
  
  इस अपडेट में, ग्रुप बनाने और उन्हें मैनेज करने के लिए, group और groupItem रिसॉर्स जोड़े गए हैं.
  - group संसाधन, Analytics ग्रुप को दिखाता है. यह ज़्यादा से ज़्यादा 200 चैनलों, वीडियो, प्लेलिस्ट या ऐसेट का कस्टम कलेक्शन होता है. एपीआई, इस संसाधन के लिए list, insert, update, और delete तरीकों के साथ काम करता है.
  - groupItem संसाधन, Analytics ग्रुप में मौजूद किसी आइटम को दिखाता है. एपीआई, इस संसाधन के लिए list, insert, और delete तरीकों के साथ काम करता है.
  उदाहरण के लिए, groups.insert तरीके का इस्तेमाल करके एक ग्रुप बनाया जा सकता है. इसके बाद, groupItems.insert तरीके का इस्तेमाल करके उस ग्रुप में आइटम जोड़े जा सकते हैं.
- किसी ग्रुप के लिए रिपोर्ट का डेटा वापस पाना
  
  डाइमेंशन के दस्तावेज़ को अपडेट किया गया है. इसमें group डाइमेंशन को शामिल किया गया है. इसका इस्तेमाल, कई चैनल रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट के लिए फ़िल्टर के तौर पर किया जा सकता है. group फ़िल्टर का इस्तेमाल करने पर, एपीआई उस ग्रुप के सभी आइटम का डेटा दिखाता है. ध्यान दें कि फ़िलहाल, एपीआई में ऐसेट ग्रुप के लिए रिपोर्ट बनाने की सुविधा उपलब्ध नहीं है.
YouTube Analytics के ग्रुप के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.

13 फ़रवरी, 2015

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई अब show डाइमेंशन के साथ काम नहीं करता.

28 अगस्त, 2014

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई में अब video, playlist, channel, और show डाइमेंशन के लिए एक से ज़्यादा वैल्यू तय की जा सकती हैं. ऐसा तब किया जा सकता है, जब इन डाइमेंशन का इस्तेमाल फ़िल्टर के तौर पर किया जाता है. एक से ज़्यादा वैल्यू तय करने के लिए, filters पैरामीटर वैल्यू को कॉमा लगाकर अलग की गई लिस्ट के तौर पर सेट करें. इस लिस्ट में वीडियो, प्लेलिस्ट, चैनल या शो के आईडी शामिल होने चाहिए. इससे एपीआई से मिली जानकारी को फ़िल्टर किया जा सकेगा. पैरामीटर वैल्यू में ज़्यादा से ज़्यादा 200 आईडी तय किए जा सकते हैं.

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

इस सुविधा के बारे में पूरी जानकारी पाने के लिए, filters पैरामीटर की परिभाषा देखें.

16 जुलाई, 2014

इस अपडेट में ये बदलाव शामिल हैं:

चैनल की रिपोर्ट को वापस पाने के लिए, अब पुष्टि किए गए उपयोगकर्ता के चैनल का डेटा वापस पाया जा सकता है. इसके लिए, ids पैरामीटर की वैल्यू को channel==MINE पर सेट करें. (आपके पास अब भी ids पैरामीटर को channel==CHANNEL_ID पर सेट करने का विकल्प है, ताकि चुने गए चैनल का डेटा वापस पाया जा सके.)
अब एपीआई, प्लेलिस्ट की रिपोर्ट के साथ काम करता है. इन रिपोर्ट में, प्लेलिस्ट के संदर्भ में वीडियो पर मिले व्यू के आंकड़े शामिल होते हैं. प्लेलिस्ट की रिपोर्ट, चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं.

प्लेलिस्ट की सभी रिपोर्ट में views और estimatedMinutesWatched मेट्रिक काम करती हैं. कुछ रिपोर्ट में averageViewDuration मेट्रिक भी काम करती है.

इसके अलावा, प्लेलिस्ट की सभी रिपोर्ट में ये नई मेट्रिक भी शामिल होती हैं. ध्यान दें कि इनमें से हर मेट्रिक, सिर्फ़ वेब पर प्लेलिस्ट को मिले व्यू दिखाती है.
- playlistStarts: इससे पता चलता है कि दर्शकों ने किसी प्लेलिस्ट को कितनी बार चलाया.
- viewsPerPlaylistStart: हर बार प्लेलिस्ट शुरू होने पर, वीडियो को मिले व्यू की औसत संख्या.
- averageTimeInPlaylist: प्लेलिस्ट शुरू होने के बाद, किसी दर्शक ने प्लेलिस्ट में मौजूद वीडियो को कितने समय तक देखा, इसका अनुमानित औसत समय (मिनट में).
प्लेलिस्ट की रिपोर्ट पाने के लिए, किसी भी अनुरोध में isCurated फ़िल्टर का इस्तेमाल करना ज़रूरी है. इसे 1 (isCurated==1) पर सेट करना ज़रूरी है.
एपीआई अब दर्शक बनाए रखने से जुड़ी रिपोर्ट के साथ काम करता है. इस रिपोर्ट से पता चलता है कि कोई वीडियो, दर्शकों को कितनी देर तक रोककर रख पाता है. रिपोर्ट का नया elapsedVideoTimeRatio डाइमेंशन, वीडियो के उस हिस्से को मेज़र करता है जो मेट्रिक वैल्यू के हिसाब से बीत चुका है:
- audienceWatchRatio मेट्रिक से, वीडियो के किसी हिस्से को देखने वाले दर्शकों के सटीक अनुपात का पता चलता है. इस अनुपात का हिसाब लगाने के लिए, वीडियो के किसी हिस्से को देखे जाने की संख्या की तुलना, वीडियो को मिले कुल व्यू की संख्या से की जाती है.
  
  ध्यान दें कि किसी वीडियो व्यू में, वीडियो के किसी हिस्से को एक से ज़्यादा बार देखा जा सकता है या हो सकता है कि उसे बिलकुल भी न देखा जाए. उदाहरण के लिए, अगर दर्शक किसी वीडियो के एक ही हिस्से को बार-बार रिवाइंड करके देखते हैं, तो वीडियो के उस हिस्से का ऐब्सलूट रेशियो 1 से ज़्यादा हो सकता है.
- relativeRetentionPerformance मेट्रिक से यह पता चलता है कि मिलती-जुलती अवधि वाले दूसरे सभी YouTube वीडियो के मुकाबले, आपके वीडियो पर कितने दर्शक बने रहे. 0 वैल्यू का मतलब है कि मिलती-जुलती अवधि वाले अन्य वीडियो की तुलना में, इस वीडियो पर दर्शकों को बनाए रखने की दर सबसे कम है. वहीं, 1 वैल्यू का मतलब है कि मिलती-जुलती अवधि वाले अन्य वीडियो की तुलना में, इस वीडियो पर दर्शकों को बनाए रखने की दर सबसे ज़्यादा है. 0.5 की मीडियन वैल्यू से पता चलता है कि मिलती-जुलती अवधि वाले आधे वीडियो, दर्शकों को बेहतर तरीके से बनाए रखते हैं. वहीं, बाकी आधे वीडियो दर्शकों को बनाए रखने में खराब परफ़ॉर्म करते हैं.
audienceType फ़िल्टर का इस्तेमाल करके, रिपोर्ट में सिर्फ़ ऑर्गैनिक व्यू, TrueView इन-स्ट्रीम विज्ञापनों से मिले व्यू या TrueView इन-डिसप्ले विज्ञापनों से मिले व्यू का डेटा देखा जा सकता है. (ऑर्गैनिक व्यू, उपयोगकर्ता की कार्रवाई का नतीजा होते हैं. जैसे, किसी वीडियो को खोजना या सुझाए गए वीडियो पर क्लिक करना.)
एपीआई, एनोटेशन से जुड़ी कई नई मेट्रिक के साथ काम करता है. यहां दी गई मेट्रिक, उन सभी रिपोर्ट से वापस पाई जा सकती हैं जिनमें पहले annotationClickThroughRate और annotationCloseRate मेट्रिक काम करती थीं.
- annotationImpressions: एनोटेशन इंप्रेशन की कुल संख्या.
- annotationClickableImpressions: इससे पता चलता है कि कितने एनोटेशन दिखे और उन पर क्लिक किया जा सकता था.
- annotationClosableImpressions: ऐसे एनोटेशन की संख्या जो दिखे और जिन्हें बंद किया जा सकता था.
- annotationClicks: क्लिक किए गए एनोटेशन की कुल संख्या.
- annotationCloses: बंद किए गए एनोटेशन की कुल संख्या.
सभी नई मेट्रिक, मुख्य मेट्रिक हैं. इन पर समर्थन नहीं होने की नीति लागू होती है. हालांकि, ध्यान दें कि नई मेट्रिक का डेटा 16 जुलाई, 2013 से उपलब्ध है. (annotationClickThroughRate और annotationCloseRate मेट्रिक का डेटा, 10 जून, 2012 से उपलब्ध है.)
GOOGLE_SEARCH को अब insightTrafficSourceType डाइमेंशन के लिए, अलग वैल्यू के तौर पर रिपोर्ट नहीं किया जाता. इसके बजाय, Google पर खोज नतीजों से मिलने वाले रेफ़रल अब EXT_URL ट्रैफ़िक सोर्स टाइप को एट्रिब्यूट किए जाते हैं. इस वजह से, अब ऐसी insightTrafficSourceDetail रिपोर्ट को वापस नहीं पाया जा सकता जिसमें insightTrafficSourceType फ़िल्टर को GOOGLE_SEARCH पर सेट किया गया हो.

31 जनवरी, 2014

इस अपडेट में ये बदलाव शामिल हैं:

कॉन्टेंट के मालिक की रिपोर्ट वाले दस्तावेज़ को अपडेट किया गया है. इससे पता चलता है कि अब subscribersGained और subscribersLost मेट्रिक को, कॉन्टेंट के मालिक के दावे वाले या उसके अपलोड किए गए कॉन्टेंट के लिए वापस पाया जा सकता है.

यह बदलाव, कॉन्टेंट के मालिकों के लिए उपलब्ध पहली बुनियादी आंकड़ों वाली रिपोर्ट में दिखता है. इसमें अब claimedStatus और uploaderType फ़िल्टर काम करते हैं.

16 जनवरी, 2014

इस अपडेट में ये बदलाव शामिल हैं:

सैंपल अनुरोधों वाले दस्तावेज़ को फिर से डिज़ाइन किया गया है, ताकि उदाहरणों को कैटगरी के हिसाब से ग्रुप किया जा सके. इसके लिए, टैब फ़ॉर्मैट का इस्तेमाल किया गया है. यह फ़ॉर्मैट, चैनल और कॉन्टेंट के मालिक की रिपोर्ट के लिए हाल ही में रिलीज़ किए गए फ़ॉर्मैट जैसा ही है. नए डिज़ाइन में, उदाहरणों को इन कैटगरी में बांटा गया है:
- बुनियादी आंकड़े
- समय के हिसाब से
- भौगोलिक
- वीडियो चलाने की जगह
- ट्रैफ़िक सोर्स
- डिवाइस/ओएस
- डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह)
- सोशल
- कमाई/विज्ञापन (सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए)
सैंपल अनुरोधों वाले दस्तावेज़ में अब चैनल की रिपोर्ट या कॉन्टेंट के मालिक की रिपोर्ट में, प्रांत के हिसाब से डेटा पाने के नए उदाहरण शामिल हैं.
- अमेरिका के राज्यों और वॉशिंगटन डी॰सी॰ के लिए, राज्य के हिसाब से मेट्रिक: इस रिपोर्ट से, किसी चैनल के वीडियो के व्यू की संख्या और अन्य आंकड़ों की जानकारी, राज्य के हिसाब से मिलती है. इस डेटा में, अमेरिका के राज्य और वॉशिंगटन डी॰सी॰ शामिल हैं. उदाहरण में, province डाइमेंशन का इस्तेमाल किया गया है. साथ ही, filters पैरामीटर का इस्तेमाल करके, जवाब को सिर्फ़ अमेरिका के नतीजों तक सीमित किया गया है.
- कैलिफ़ोर्निया में दर्शकों की डेमोग्राफ़िक्स (उम्र समूह और लिंग): इस रिपोर्ट से, कैलिफ़ोर्निया में रहने वाले उन दर्शकों की उम्र समूह और लिंग के बारे में आंकड़े मिलते हैं जिन्होंने किसी चैनल के वीडियो देखे हैं. इसके अलावा, कॉन्टेंट के मालिक की रिपोर्ट के लिए, कॉन्टेंट के मालिक के दावे वाले कॉन्टेंट को देखने वाले दर्शकों के आंकड़े मिलते हैं. इस उदाहरण में, filters पैरामीटर का इस्तेमाल किया गया है, ताकि यह पक्का किया जा सके कि जवाब में सिर्फ़ किसी खास प्रांत का डेटा शामिल हो.
province डाइमेंशन की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि जब province को dimensions पैरामीटर वैल्यू में शामिल किया जाता है, तो अनुरोध में country==US को filters पैरामीटर वैल्यू में शामिल करके, डेटा को अमेरिका तक सीमित करना ज़रूरी है.

6 जनवरी, 2014

इस अपडेट में ये बदलाव शामिल हैं:

जिन दस्तावेज़ों में, चैनल और कॉन्टेंट के मालिक की रिपोर्ट के बारे में बताया गया है उन्हें फिर से डिज़ाइन किया गया है. सभी संभावित रिपोर्ट की सूची वाली टेबल देने के बजाय, हर दस्तावेज़ में रिपोर्ट को कैटगरी में बांटा जाता है:
- बुनियादी आंकड़े
- समय के हिसाब से
- भौगोलिक
- वीडियो चलाने की जगह
- ट्रैफ़िक सोर्स
- डिवाइस/ओएस
- डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह)
- सोशल
- सबसे ज़्यादा देखे गए वीडियो
हर दस्तावेज़ में ये कैटगरी, टैब की सूची के तौर पर दिखती हैं. किसी भी टैब पर क्लिक करके, उस कैटगरी में मौजूद रिपोर्ट देखी जा सकती हैं.
एपीआई में अब तीन नए भौगोलिक डाइमेंशन इस्तेमाल किए जा सकते हैं: province, continent, और subContinent.
- province डाइमेंशन की मदद से, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के आंकड़े देखे जा सकते हैं. एपीआई, इस डाइमेंशन के लिए दो तरह के इस्तेमाल की सुविधा देता है:
  - एपीआई में दो रिपोर्ट उपलब्ध हैं. इनमें, राज्य के हिसाब से आंकड़ों को अलग-अलग करके दिखाया जाता है. दोनों रिपोर्ट, चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं.
    - मुख्य आंकड़ों की रिपोर्ट में कई तरह के आंकड़े मिलते हैं. इनमें व्यू की संख्या और वीडियो देखे जाने के अनुमानित मिनट शामिल हैं.
    - समय के हिसाब से तैयार की गई रिपोर्ट में भी वही आंकड़े होते हैं. हालांकि, इसमें डेटा को हर दिन, 7 दिन, 30 दिन या महीने के हिसाब से इकट्ठा किया जाता है.
  - filters क्वेरी पैरामीटर का इस्तेमाल करके, किसी रिपोर्ट को सिर्फ़ किसी खास राज्य के आंकड़ों तक सीमित किया जा सकता है. इस तरह के फ़िल्टर का इस्तेमाल कई रिपोर्ट में किया जा सकता है. इनमें भौगोलिक रिपोर्ट, वीडियो देखे जाने की जगह की रिपोर्ट, ट्रैफ़िक सोर्स की रिपोर्ट, डिवाइस की रिपोर्ट, ऑपरेटिंग सिस्टम की रिपोर्ट, डेमोग्राफ़िक रिपोर्ट, और सबसे ज़्यादा देखे गए वीडियो की रिपोर्ट शामिल हैं.
- continent डाइमेंशन, संयुक्त राष्ट्र (यूएन) के आंकड़ों के हिसाब से तय किए गए क्षेत्र का कोड बताता है. इससे किसी महाद्वीप की पहचान होती है. इस डाइमेंशन का इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर किया जा सकता है.
- subContinent डाइमेंशन, संयुक्त राष्ट्र (यूएन) के आंकड़ों के हिसाब से तय किए गए क्षेत्र का कोड बताता है. इससे किसी महाद्वीप के उप-क्षेत्र की पहचान की जाती है. इस डाइमेंशन का इस्तेमाल भी सिर्फ़ फ़िल्टर के तौर पर किया जा सकता है.
  
  हर उप-क्षेत्र सिर्फ़ एक महाद्वीप से जुड़ा होता है. इसलिए, subContinent फ़िल्टर का इस्तेमाल करते समय, continent फ़िल्टर का इस्तेमाल करने की ज़रूरत नहीं होती. (अगर किसी अनुरोध में दोनों डाइमेंशन का इस्तेमाल किया जाता है, तो एपीआई गड़बड़ी का मैसेज दिखाएगा.)
दस्तावेज़ में सुधार किया गया है, ताकि insightTrafficSourceDetail डाइमेंशन में insightTrafficSourceType वैल्यू PROMOTED को मान्य फ़िल्टर वैल्यू के तौर पर शामिल न किया जाए.

30 सितंबर, 2013

इस अपडेट में ये बदलाव शामिल हैं:

YouTube Analytics API पर अब सेवा की शर्तों में बताई गई, समर्थन नहीं होने की नीति लागू होती है. हालांकि, एपीआई के नॉन-कोर डाइमेंशन और नॉन-कोर मेट्रिक पर, समर्थन नहीं होने की नीति लागू नहीं होती. डाइमेंशन और मेट्रिक पेजों को अपडेट किया गया है, ताकि मुख्य डाइमेंशन और मुख्य मेट्रिक को लिस्ट किया जा सके. इसके अलावा, उन पेजों पर मौजूद परिभाषाओं को अपडेट किया गया है, ताकि मुख्य डाइमेंशन और मेट्रिक की साफ़ तौर पर पहचान की जा सके.
एपीआई अब insightPlaybackLocationType डाइमेंशन की वैल्यू के तौर पर EXTERNAL_APP के साथ काम करता है. इस अपडेट के साथ, 10 सितंबर, 2013 से वीडियो चलाने की संख्या को MOBILE के तौर पर कैटगरी में नहीं रखा जाएगा. हालांकि, उस तारीख से पहले मोबाइल पर वीडियो चलाने की संख्या को अब भी उसी वैल्यू के साथ कैटगरी में रखा जाएगा.

इस अपडेट के बाद, मोबाइल पर वीडियो चलाने की सुविधा को अब WATCH, EMBEDDED या EXTERNAL_APP के तौर पर बांटा गया है. यह इस बात पर निर्भर करता है कि वीडियो किस तरह के ऐप्लिकेशन पर चलाया जा रहा है.
एपीआई अब insightTrafficSourceType डाइमेंशन की वैल्यू के तौर पर PLAYLIST के साथ काम करता है. इस वैल्यू से पता चलता है कि वीडियो को प्लेलिस्ट से रेफ़र किया गया था. पहले, इन व्यू को डाइमेंशन की YT_OTHER_PAGE कैटगरी का इस्तेमाल करके बांटा जाता था.

16 जुलाई, 2013

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई अब कई डाइमेंशन और मेट्रिक के हिसाब से रिपोर्ट को क्रम से लगाने की सुविधा देता है. सैंपल अनुरोधों के दस्तावेज़ में एक नया उदाहरण शामिल है, अनुरोधों को कई डाइमेंशन/मेट्रिक के हिसाब से क्रम में लगाना. इससे इस सुविधा के बारे में पता चलता है. अनुरोध से ट्रैफ़िक सोर्स का डेटा मिलता है. साथ ही, इसमें sort पैरामीटर की वैल्यू day,-views होती है. नतीजों को समय के हिसाब से क्रम में लगाया जाता है. हालांकि, हर दिन के नतीजों के सेट में, पहली लाइन में उस ट्रैफ़िक सोर्स का डेटा होता है जिससे सबसे ज़्यादा व्यू मिले. दूसरी लाइन में उस सोर्स का डेटा होता है जिससे सबसे ज़्यादा व्यू मिले. इसी तरह, अन्य लाइन में भी डेटा होता है.
एपीआई अब दो नए डाइमेंशन, deviceType और operatingSystem के साथ काम करता है. इनका इस्तेमाल करके, उन डिवाइसों का डेटा हासिल किया जा सकता है जिन पर दर्शक आपके वीडियो देख रहे हैं. एपीआई, उन रिपोर्ट के साथ काम करता है जिनमें इनमें से किसी एक या दोनों डाइमेंशन का इस्तेमाल किया जाता है.
- deviceType रिपोर्ट से, डेस्कटॉप, मोबाइल, और टैबलेट जैसे अलग-अलग तरह के डिवाइसों के लिए, व्यू की संख्या और वीडियो देखने के अनुमानित कुल समय की जानकारी मिलती है. operatingSystem फ़िल्टर का इस्तेमाल करके, डिवाइस टाइप की रिपोर्ट को सीमित किया जा सकता है. इससे रिपोर्ट में सिर्फ़ उन डिवाइसों के आंकड़े शामिल होंगे जो किसी खास ऑपरेटिंग सिस्टम पर काम करते हैं. जैसे, Android या iOS.
- operatingSystem रिपोर्ट से, Android, iOS, Linux वगैरह जैसे अलग-अलग ऑपरेटिंग सिस्टम के लिए, व्यू की संख्या और वीडियो देखने में बिताए गए अनुमानित समय की जानकारी मिलती है. deviceType फ़िल्टर का इस्तेमाल करके, ऑपरेटिंग सिस्टम की रिपोर्ट को सिर्फ़ किसी खास तरह के डिवाइस के आंकड़ों तक सीमित किया जा सकता है. जैसे, मोबाइल डिवाइस या टैबलेट.
डिवाइस टाइप और ऑपरेटिंग सिस्टम की नई रिपोर्ट, चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं.
सैंपल अनुरोधों वाले दस्तावेज़ को अपडेट किया गया है. इसमें चैनलों के लिए डिवाइस की तीन रिपोर्ट और कॉन्टेंट के मालिकों के लिए डिवाइस की तीन रिपोर्ट शामिल की गई हैं.
insightPlaybackLocationType डाइमेंशन, YT_OTHER वैल्यू दिखा सकता है. इससे उन व्यू की पहचान की जाती है जिन्हें डाइमेंशन की किसी अन्य वैल्यू का इस्तेमाल करके कैटगरी में नहीं रखा गया है.

23 मई, 2013

इस अपडेट में ये बदलाव शामिल हैं:

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

10 मई, 2013

इस अपडेट में ये बदलाव शामिल हैं:

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

6 मई, 2013

इस अपडेट में ये बदलाव शामिल हैं:

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

इस बदलाव को दिखाने के लिए, उपलब्ध चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट की सूचियों को अपडेट किया गया है. (अब ये सूचियां छोटी हो गई हैं, क्योंकि देखने के कुल समय की मेट्रिक को सूची में शामिल अन्य रिपोर्ट के हिस्से के तौर पर वापस पाया जा सकता है.)

एपीआई अनुरोधों के सैंपल वाले दस्तावेज़ को भी अपडेट किया गया है.
insightPlaybackLocationDetail और insightTrafficSourceDetail डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट को इन तरीकों से बेहतर बनाया गया है:
- अब इनमें country फ़िल्टर का इस्तेमाल किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.
- कॉन्टेंट के मालिक, अब filter के इन नए कॉम्बिनेशन में से किसी एक का इस्तेमाल करके, ये रिपोर्ट वापस पा सकते हैं. ध्यान दें कि इन सभी कॉम्बिनेशन में, country फ़िल्टर का भी इस्तेमाल किया जा सकता है. हालांकि, इसका इस्तेमाल करना ज़रूरी नहीं है.
  - वीडियो चलाने की जगह की जानकारी
    - channel,insightPlaybackLocationType==EMBEDDED
    - show,insightPlaybackLocationType==EMBEDDED
    - claimedStatus,insightPlaybackLocationType==EMBEDDED
    - uploaderType,insightPlaybackLocationType==EMBEDDED
    - uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
  - ट्रैफ़िक सोर्स की जानकारी
    - channel,insightTrafficSourceType
    - show,insightTrafficSourceType
    - claimedStatus,insightTrafficSourceType
    - uploaderType,insightTrafficSourceType
    - uploaderType,claimedStatus,insightTrafficSourceType

3 मई, 2013

इस अपडेट में ये बदलाव शामिल हैं:

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

28 मार्च, 2013

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई अब दो नई मेट्रिक, annotationClickThroughRate और annotationCloseRate के साथ काम करता है. ये मेट्रिक, वीडियो के दौरान दिखने वाले एनोटेशन के साथ दर्शकों के इंटरैक्शन से जुड़ी हैं. चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट, दोनों की सूचियों को अपडेट कर दिया गया है. इससे उन रिपोर्ट की पहचान की जा सकेगी जिनमें नई मेट्रिक काम करती हैं.
- annotationClickThroughRate – क्लिक करने लायक एनोटेशन के कुल इंप्रेशन की तुलना में, दर्शकों ने जितने एनोटेशन पर क्लिक किया उनका अनुपात.
- annotationCloseRate – दर्शकों ने जितने एनोटेशन बंद किए और एनोटेशन के कुल इंप्रेशन का अनुपात.

21 मार्च, 2013

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई में अब आय और विज्ञापन की परफ़ॉर्मेंस मेट्रिक के साथ-साथ, विज्ञापन की परफ़ॉर्मेंस की नई रिपोर्ट भी उपलब्ध हैं. मेट्रिक और रिपोर्ट सिर्फ़ उन YouTube कॉन्टेंट पार्टनर के लिए उपलब्ध हैं जो YouTube Partner Program में शामिल हैं.
- इन नई रिपोर्ट में, वीडियो चलाने पर आधारित विज्ञापन की परफ़ॉर्मेंस मेट्रिक और इंप्रेशन के आधार पर विज्ञापन की परफ़ॉर्मेंस मेट्रिक शामिल होती हैं. विज्ञापन की परफ़ॉर्मेंस रिपोर्ट के बारे में ज़्यादा जानने के लिए, कॉन्टेंट के मालिक की रिपोर्ट दस्तावेज़ देखें.
- नई मेट्रिक की सूची यहां दी गई है. कॉन्टेंट के मालिक की रिपोर्ट की सूची को अपडेट किया गया है, ताकि इन मेट्रिक के साथ काम करने वाली रिपोर्ट की पहचान की जा सके. इनमें दो नई रिपोर्ट भी शामिल हैं.
  - earnings – Google के बेचे गए सभी विज्ञापन स्रोतों से होने वाली कुल अनुमानित आय.
  - grossRevenue – Google या DoubleClick पार्टनर से मिलने वाला अनुमानित कुल रेवेन्यू.
  - primaryAdGrossRevenue – Google या DoubleClick पार्टनर से मिले अनुमानित कुल रेवेन्यू की जानकारी. इसे रिपोर्ट में शामिल वीडियो प्लेबैक के लिए, विज्ञापन के मुख्य टाइप के हिसाब से जोड़कर और अलग-अलग करके दिखाया जाता है.
  - monetizedPlaybacks – ऐसे वीडियो प्लेबैक की संख्या जिनमें कम से कम एक विज्ञापन इंप्रेशन दिखाया गया.
  - playbackBasedCpm – वीडियो को एक हज़ार बार चलाए जाने पर मिलने वाला कुल अनुमानित रेवेन्यू.
  - impressions – दिखाए गए विज्ञापन इंप्रेशन की संख्या.
  - impressionBasedCpm – हर हज़ार विज्ञापन इंप्रेशन पर मिलने वाला अनुमानित कुल रेवेन्यू.
  ध्यान दें: पूरी जानकारी के लिए, मेट्रिक की परिभाषाएं देखें.
- आय या विज्ञापन की परफ़ॉर्मेंस मेट्रिक को वापस पाने के लिए, अनुमति वाला टोकन भेजना ज़रूरी है. इससे नए https://www.googleapis.com/auth/yt-analytics-monetary.readonly स्कोप का इस्तेमाल करके ऐक्सेस मिलता है.
एपीआई के दस्तावेज़ को फिर से व्यवस्थित किया गया है, ताकि अलग-अलग तरह की रिपोर्ट के बारे में अलग-अलग पेजों पर जानकारी दी जा सके. इसलिए, अब अलग-अलग तरह की चैनल रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट के बारे में जानकारी देने वाले अलग-अलग पेज मौजूद हैं.

4 फ़रवरी, 2013

इस अपडेट में ये बदलाव शामिल हैं:

एपीआई की रेफ़रंस गाइड में अब उदाहरण सेक्शन शामिल है. इसमें कोड सैंपल दिए गए हैं. इनसे पता चलता है कि Java, JavaScript, Python, और Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करके, एपीआई को कैसे कॉल किया जाता है. JavaScript कोड सैंपल वही है जिसके बारे में सैंपल ऐप्लिकेशन के दस्तावेज़ में विस्तार से बताया गया है.

14 नवंबर, 2012

इस अपडेट में ये बदलाव शामिल हैं:

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

2 अक्टूबर, 2012

इस अपडेट में ये बदलाव शामिल हैं:

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

12 सितंबर, 2012

इस अपडेट में ये बदलाव शामिल हैं:

कोटा के इस्तेमाल को समझना सेक्शन में, एपीआई कोटा के इस्तेमाल को ऑप्टिमाइज़ करने के लिए दिशा-निर्देश दिए गए हैं. एपीआई सर्वर, हर अनुरोध के लिए क्वेरी की लागत का हिसाब लगाता है. यह लागत, एपीआई के इस्तेमाल के कोटे से काट ली जाती है. अलग-अलग तरह की रिपोर्ट के लिए, क्वेरी की लागत काफ़ी अलग हो सकती है. इसलिए, आपको अपने कोटे का इस्तेमाल सोच-समझकर करना चाहिए. साथ ही, आपके ऐप्लिकेशन को सिर्फ़ उन मेट्रिक और डेटा का अनुरोध करना चाहिए जिनकी उसे वाकई ज़रूरत है.
समय के डाइमेंशन सेक्शन को अपडेट किया गया है. इससे यह पता चलता है कि उन डाइमेंशन से यह पता चलता है कि Analytics रिपोर्ट को किसी समयावधि के आधार पर डेटा इकट्ठा करना चाहिए. एपीआई अब समय से जुड़े इन अतिरिक्त डाइमेंशन के साथ काम करता है:
- 7DayTotals – रिपोर्ट में मौजूद डेटा को एग्रीगेट किया जाएगा, ताकि हर लाइन में सात दिनों की अवधि का डेटा शामिल हो.
- 30DayTotals – रिपोर्ट में मौजूद डेटा को एग्रीगेट किया जाएगा, ताकि हर लाइन में 30 दिनों की अवधि का डेटा शामिल हो.
- month – रिपोर्ट में मौजूद डेटा को कैलेंडर के महीने के हिसाब से एग्रीगेट किया जाएगा.
इसी तरह, उपलब्ध रिपोर्ट सेक्शन को अपडेट किया गया है, ताकि यह पता चल सके कि एपीआई, इन डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट के साथ काम करता है.
रिपोर्टिंग इकाई के डाइमेंशन सेक्शन को अपडेट किया गया है. इसमें बताया गया है कि कॉन्टेंट के मालिक की रिपोर्ट पाने के लिए किए जाने वाले एपीआई अनुरोधों में, डेटा को फ़िल्टर करना ज़रूरी है. इसके लिए, इनमें से किसी एक डाइमेंशन (video, channel या show) या claimedStatus और uploaderType डाइमेंशन के साथ काम करने वाले कॉम्बिनेशन का इस्तेमाल किया जाना चाहिए.
अब एपीआई, सबसे लोकप्रिय वीडियो की रिपोर्ट को क्रम से लगाने के लिए दो नए विकल्प उपलब्ध कराता है. ये रिपोर्ट, चैनल की रिपोर्ट या कॉन्टेंट के मालिक की रिपोर्ट के तौर पर उपलब्ध होती हैं. इनमें देश के हिसाब से मेट्रिक (व्यू, टिप्पणियां, पसंद वगैरह) शामिल होती हैं. साथ ही, इन मेट्रिक को वीडियो के हिसाब से अलग-अलग दिखाया जाता है. अब इन रिपोर्ट को, वीडियो के वॉच पेज से चैनल की सदस्यता लेने या छोड़ने वाले उपयोगकर्ताओं की संख्या के हिसाब से क्रम में लगाया जा सकता है.
मेट्रिक subscribersGained और subscribersLost की परिभाषाओं को अपडेट किया गया है. इससे यह पता चलता है कि किसी चैनल के सदस्यों की संख्या में कई जगहों पर बढ़ोतरी या कमी हो सकती है. इनमें वीडियो वॉच पेज, चैनल पेज, और YouTube के होम पेज पर दिखने वाली गाइड शामिल है. जब ये मेट्रिक किसी वीडियो की रिपोर्ट में दिखती हैं, तो उनमें सिर्फ़ उस वीडियो के वॉच पेज के आंकड़े शामिल होते हैं.