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

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

22 सितंबर, 2025

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

24 जून, 2025

26 मार्च, 2025 को किए गए एलान के मुताबिक, शॉर्ट वीडियो के व्यू की संख्या में हुए बदलाव के तहत, 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 (बल्क रिपोर्ट) API में ये बदलाव किए जाएंगे:

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

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

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

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

3 मार्च, 2025

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

ध्यान दें: यह सुविधा बंद होने की सूचना है.

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

15 नवंबर, 2024

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

YouTube Analytics (Targeted Queries) API के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि ट्रैफ़िक सोर्स की रिपोर्ट के लिए, एपीआई का reports.query तरीका अब गड़बड़ी का मैसेज दिखाता है. ऐसा तब होता है, जब क्वेरी किए गए वीडियो की संख्या X तारीख की सीमा में दिनों की संख्या का प्रॉडक्ट 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 डाइमेंशन हटाने पर, बैकवर्ड कंपैटिबिलिटी बनाए रखने के लिए, आपको अपने कोड को भी अपडेट करना होगा. इससे, प्लेलिस्ट की रिपोर्ट के लिए सिर्फ़ 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 के बाद काम नहीं करेगी. इसके हिसाब से, उस डाइमेंशन की परिभाषा को अपडेट कर दिया गया है.

    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 (टारगेट की गई क्वेरी) एपीआई को अपडेट कर दिया गया है, ताकि दो 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 (टारगेट की गई क्वेरी) 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 (Bulk Reports) API में, फ़िलहाल gender डाइमेंशन के लिए तीन वैल्यू उपलब्ध हैं: FEMALE, MALE, और GENDER_OTHER. 11 अगस्त, 2022 को या इसके बाद, इस्तेमाल की जा सकने वाली वैल्यू का सेट बदलकर FEMALE, MALE, और USER_SPECIFIED हो जाएगा.

9 फ़रवरी, 2022

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

2 फ़रवरी, 2022

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

  • YouTube Reporting (Bulk Reports) 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 (Bulk Reports) API में, traffic_source_type डाइमेंशन, 24 वैल्यू के साथ काम करता है.

इस नए ट्रैफ़िक सोर्स टाइप के लिए, ट्रैफ़िक सोर्स की ज़्यादा जानकारी देने वाला डाइमेंशन नहीं भरा जाता. यह डाइमेंशन, insightTrafficSourceDetail YouTube Analytics API या traffic_source_detail YouTube Reporting API में मौजूद होता है.

20 जुलाई, 2020

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

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

13 फ़रवरी, 2020

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

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

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

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

ये वैल्यू, 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 दिनों की अवधि के हिसाब से डेटा को इकट्ठा या उससे नया डेटा जनरेट कर सकते हैं. उदाहरण के लिए:

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

27 जून, 2019

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

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

1 नवंबर, 2018

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

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

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

17 सितंबर, 2018

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

  • डेटा मॉडल की खास जानकारी देने वाले दस्तावेज़ में, डेटा की पहचान छिपाने के नए सेक्शन में बताया गया है कि मेट्रिक में तय सीमा से कम डेटा होने पर, 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 Data API का इस्तेमाल करके, YouTube Analytics API की प्रतिक्रियाओं में पहचाने गए संसाधनों के लिए अतिरिक्त मेटाडेटा वापस पाया जा सकता है. YouTube API की सेवाओं के लिए डेवलपर से जुड़ी नीतियों (सेक्शन III.E.4.b से III.E.4.d) में बताया गया है कि API क्लाइंट को 30 दिनों के बाद, उस API से सेव किए गए संसाधन के मेटाडेटा को मिटाना या रीफ़्रेश करना होगा.

22 मई, 2018

इस अपडेट में, YouTube Reporting (Bulk Reports) 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) में बताया गया है कि API क्लाइंट को 30 दिनों के बाद, उस API से सेव किए गए संसाधन के मेटाडेटा को मिटाना या रीफ़्रेश करना होगा.

  • रिपोर्ट की विशेषताएं सेक्शन को अपडेट किया गया है. इसमें बताया गया है कि रिपोर्ट के डेटा को फ़िल्टर नहीं किया जाता. हालांकि, 1 जून, 2018 या इसके बाद की अवधि का डेटा दिखाने वाली रिपोर्ट में, YouTube के उन संसाधनों के रेफ़रंस शामिल नहीं होंगे जिन्हें रिपोर्ट जनरेट होने की तारीख से कम से कम 30 दिन पहले मिटा दिया गया था.

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

  • एपीआई की खास जानकारी के बैकफ़िल डेटा सेक्शन को अपडेट किया गया है. इससे बैकफ़िल डेटा को ज़्यादा साफ़ तौर पर एक ऐसे डेटा सेट के तौर पर परिभाषित किया जा सकेगा जो पहले डिलीवर किए गए सेट की जगह लेता है.

26 अप्रैल, 2018

YouTube Analytics (टारगेट की गई क्वेरी) API (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 API में काम नहीं करती हैं:

    • reports.query तरीके में अब alt, quotaUser, और userIp अनुरोध पैरामीटर काम नहीं करते.
    • v2 एपीआई में ऐसा बैच एंडपॉइंट नहीं है जो अलग-अलग एपीआई के अनुरोधों से बने बैच के साथ काम करता हो. (हालांकि, एक बैच में एक ही एपीआई के अलग-अलग तरीकों के अनुरोध शामिल हो सकते हैं.) यह सुविधा सिर्फ़ YouTube Analytics API के लिए बंद नहीं की जा रही है. Google, अपने सभी एपीआई के लिए ग्लोबल बैच एंडपॉइंट बंद कर रहा है.
    • v2 API, JSON-RPC प्रोटोकॉल के साथ काम नहीं करता. यह प्रोटोकॉल, v1 API के साथ काम करता था. एक बार फिर बता दें कि यह सुविधा बंद होने का असर सिर्फ़ YouTube Analytics API पर नहीं पड़ेगा.

  • ध्यान दें: यह सुविधा बंद होने की सूचना है.

    एपीआई का पहला वर्शन (v1) अब काम नहीं करता. यह 31 अक्टूबर, 2018 तक काम करेगा. इस तारीख के बाद, v1 API के लिए किए गए सभी अनुरोध काम नहीं करेंगे. इसलिए, कृपया 31 अक्टूबर, 2018 से पहले v2 API पर अपग्रेड कर लें, ताकि आपको एपीआई के ज़रिए 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 तक उपलब्ध हैं, तो यह वह आखिरी तारीख होगी जिसके लिए डेटा को जवाब में शामिल किया जाएगा. (ऐसा तब भी होता है, जब अनुरोध की गई कुछ मेट्रिक का डेटा 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 के ज़रिए भी रेवेन्यू का डेटा ऐक्सेस कर सकते हैं:

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 घंटे की अवधि को दिखाती है और पैसिफ़िक समय हमेशा UTC-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 घंटे की अवधि को दिखाती हैं. (इससे पहले, दस्तावेज़ में बताया गया था कि पैसिफ़िक समय UTC-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 रिपोर्ट ने ले ली है.

  • कॉन्टेंट के मालिक के लिए रिपोर्ट

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

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 को दी गई थी.)

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_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 वैल्यू के साथ काम करता है. यह बंपर विज्ञापनों के बारे में बताता है. ये स्किप नहीं किए जा सकने वाले 6 सेकंड तक के वीडियो विज्ञापन होते हैं. इनके खत्म होने के बाद ही, वीडियो देखा जा सकता है.

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 रिपोर्ट को बंद कर दिया गया है. अगर आपके पास उस रिपोर्ट के लिए कोई जॉब है, तो आपको YouTube से यह उम्मीद नहीं रखनी चाहिए कि वह 19 अगस्त, 2016 के बाद उस जॉब के लिए नई रिपोर्ट जनरेट करेगा. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 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 से अलग है. 14 से पता चलता है कि वीडियो को प्लेलिस्ट के हिस्से के तौर पर चलाया गया था.

YouTube Analytics API

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

8 फ़रवरी, 2016

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

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

6 जनवरी, 2016

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

  • YouTube Reporting API में, operating_system डाइमेंशन, Chromecast के ज़रिए होने वाले व्यू की पहचान करने के लिए 21 वैल्यू का इस्तेमाल करता है.
  • 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

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

29 अक्टूबर, 2015

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

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

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

  • YouTube Reporting API के jobs.reports.list() तरीके में अब createdAfter क्वेरी पैरामीटर काम करता है. अगर इस पैरामीटर को तय किया जाता है, तो इससे पता चलता है कि एपीआई रिस्पॉन्स में सिर्फ़ उन रिपोर्ट को शामिल किया जाना चाहिए जिन्हें तय की गई तारीख और समय के बाद बनाया गया है. इसमें बैकफ़िल किए गए डेटा वाली नई रिपोर्ट भी शामिल हैं. ध्यान दें कि पैरामीटर की वैल्यू, रिपोर्ट बनाने के समय से जुड़ी होती है. यह उस तारीख से जुड़ी नहीं होती है जिस तारीख का डेटा दिखाया जाता है.

    पैरामीटर की वैल्यू, आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप है. यह माइक्रोसेकंड तक सटीक होता है. उदाहरण: "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 का डेटा पाने की सुविधा देते हैं. दोनों एपीआई एक जैसे डेटा सेट का ऐक्सेस देते हैं. इसलिए, दोनों एपीआई के दस्तावेज़ों को एक ही सेट के तौर पर पब्लिश किया जा रहा है.

    • दस्तावेज़ के सेट में मौजूद गाइड टैब में, दोनों एपीआई के बारे में सामान्य जानकारी दी गई है. इसमें एपीआई अनुरोधों को अनुमति देने के निर्देश भी शामिल हैं.
    • बल्क रिपोर्ट टैब में, 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

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

  • API अब वीडियो रिपोर्ट के लिए दो नई मेट्रिक, videosAddedToPlaylists और videosRemovedFromPlaylists के साथ काम करता है. चैनलों और कॉन्टेंट के मालिकों के लिए, वीडियो की शिकायत वाली सूचियों को अपडेट किया गया है. इससे यह पता लगाया जा सकता है कि कौनसी शिकायतें नई मेट्रिक के साथ काम करती हैं.

    • videosAddedToPlaylists – इससे पता चलता है कि क्वेरी के दायरे में आने वाले वीडियो को YouTube की किसी प्लेलिस्ट में कितनी बार जोड़ा गया. वीडियो को, वीडियो के मालिक की प्लेलिस्ट या दूसरे चैनलों की प्लेलिस्ट में जोड़ा जा सकता है.
    • videosRemovedFromPlaylists – क्वेरी के दायरे में आने वाले वीडियो को YouTube की किसी भी प्लेलिस्ट से हटाए जाने की संख्या. ऐसा हो सकता है कि वीडियो के मालिक ने अपनी प्लेलिस्ट से वीडियो हटा दिए हों या अन्य चैनलों की प्लेलिस्ट से वीडियो हटा दिए गए हों.

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

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

31 मार्च, 2015

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

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

16 मार्च, 2015

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

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

    पैरामीटर की वैल्यू, ISO 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 डाइमेंशन की परिभाषा को अपडेट किया गया है. इसमें बताया गया है कि जब dimensions पैरामीटर वैल्यू में province शामिल किया जाता है, तो अनुरोध में डेटा को सिर्फ़ अमेरिका तक सीमित रखना होगा. इसके लिए, filters पैरामीटर वैल्यू में country==US को शामिल करना होगा.

6 जनवरी, 2014

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

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

    • बुनियादी आंकड़े
    • समय के हिसाब से
    • भौगोलिक
    • वीडियो चलाने की जगह
    • ट्रैफ़िक सोर्स
    • डिवाइस/ओएस
    • डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह)
    • सोशल
    • सबसे ज़्यादा देखे गए वीडियो

    हर दस्तावेज़ में, इन कैटगरी को टैब की सूची के तौर पर दिखाया जाता है. किसी भी टैब पर क्लिक करके, उस कैटगरी में काम करने वाली रिपोर्ट देखी जा सकती हैं.

  • एपीआई अब तीन नए भौगोलिक डाइमेंशन के साथ काम करता है: province, continent, और subContinent.

    • province डाइमेंशन की मदद से, अमेरिका के राज्यों और डिस्ट्रिक्ट ऑफ़ कोलंबिया के आंकड़े पाए जा सकते हैं. एपीआई, इस डाइमेंशन का इस्तेमाल दो तरीकों से करता है:

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

        • मुख्य आंकड़ों की रिपोर्ट में कई तरह के आंकड़े मिलते हैं. जैसे, व्यू की संख्या और वीडियो देखने का अनुमानित समय.
        • समय के हिसाब से तैयार की गई रिपोर्ट में भी यही आंकड़े मिलते हैं. हालांकि, इसमें डेटा को हर दिन, सात दिन, 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

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

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 के होम पेज पर दिखने वाली गाइड. जब ये मेट्रिक, वीडियो से जुड़ी रिपोर्ट में दिखती हैं, तो इनमें सिर्फ़ उस वीडियो के वॉच पेज के आंकड़े शामिल होते हैं.