बदलावों का इतिहास

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

6 मई, 2024

YouTube Analytics (टारगेट की गई क्वेरी) एपीआई, चैनलों के लिए तीन नई रिपोर्ट के साथ काम करता है:

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

7 अप्रैल, 2024

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

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

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

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

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

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

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

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

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

  • नीचे दी गईं नई इन-प्लेलिस्ट मेट्रिक की मदद से, प्लेलिस्ट की रिपोर्ट बनाई जा सकती हैं कॉन्टेंट के मालिक. ध्यान दें कि ये मेट्रिक सिर्फ़ तब काम करती हैं, जब एपीआई रिपोर्ट में isCurated डाइमेंशन का इस्तेमाल नहीं किया गया है. ज़्यादा जानकारी के लिए, metric दस्तावेज़ हर मेट्रिक की परिभाषाएं:

  • views का व्यवहार अब मेट्रिक इस बात पर निर्भर करेगी कि प्लेलिस्ट रिपोर्ट को वापस लाने वाले एपीआई अनुरोध ने isCurated डाइमेंशन:

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

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

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

19 जनवरी, 2024

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

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

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

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

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

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

  • प्लेलिस्ट से जुड़ी रिपोर्ट चैनल की रिपोर्ट के दस्तावेज़ के सेक्शन को अपडेट कर दिया गया है. प्लेलिस्ट रिपोर्ट के लिए इस्तेमाल होने वाली मेट्रिक के टाइप:

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

  • चैनलों की प्लेलिस्ट रिपोर्ट में, इन-प्लेलिस्ट की ये नई मेट्रिक इस्तेमाल की जा सकती हैं. फ़िलहाल, कॉन्टेंट के मालिक की रिपोर्ट के लिए, ये मेट्रिक उपलब्ध नहीं हैं. ध्यान दें कि ये मेट्रिक समर्थित नहीं है, बशर्ते रिपोर्ट को पुनः प्राप्त करने का API अनुरोध का उपयोग करता हो isCurated डाइमेंशन. ज़्यादा जानकारी के लिए, metric दस्तावेज़ हर मेट्रिक की परिभाषाएं:

  • views का व्यवहार अब मेट्रिक इस बात पर निर्भर करेगी कि प्लेलिस्ट रिपोर्ट को वापस लाने वाले एपीआई अनुरोध ने isCurated डाइमेंशन:

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

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

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

04 दिसंबर, 2023

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

15 दिसंबर, 2022

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

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

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

    creatorContentType डाइमेंशन, सभी के लिए वैकल्पिक डाइमेंशन के तौर पर काम करता है चैनल और कॉन्टेंट के मालिक की वीडियो रिपोर्ट से.

  • YouTube Analytics API के अनुरोधों के सैंपल वाली गाइड में, अब दोनों नए डाइमेंशन के उदाहरण शामिल किए गए हैं.

  • 7DayTotals और 30DayTotals डाइमेंशन के रेफ़रंस दिए गए हैं दस्तावेज़ से हटा दिया गया है. इन डाइमेंशन को बंद करने का एलान अक्टूबर में किया गया था 2019.

26 अगस्त, 2022

YouTube Analytics (टारगेट की गई क्वेरी) एपीआई और YouTube Reporting (एक साथ कई रिपोर्ट) एपीआई, दोनों नए ट्रैफ़िक सोर्स की जानकारी वाली वैल्यू को शामिल करें:

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

11 फ़रवरी, 2022

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

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

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

9 फ़रवरी, 2022

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

2 फ़रवरी, 2022

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

  • YouTube Reporting (बल्क रिपोर्ट) एपीआई में, traffic_source_type अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है डाइमेंशन, 28 मान का समर्थन करता है.

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

23 सितंबर, 2020

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

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

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

20 जुलाई, 2020

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

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

13 फ़रवरी, 2020

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

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

अपलोड किए गए वीडियो और लाइव स्ट्रीम के लिए, नई वैल्यू के हिसाब से मिलने वाली सूचनाएं. uploaded के रूप में दो श्रेणियों में रिपोर्ट किया गया है:

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

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

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

15 अक्टूबर, 2019

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

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

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

    ध्यान दें कि उपयोगकर्ता, day डाइमेंशन का इस्तेमाल करके क्वेरी करके और सात या 30 दिनों की अवधि के दौरान डेटा को एग्रीगेट करके या हासिल कर सकते हैं. इससे, उपयोगकर्ता इन डाइमेंशन के लिए कुछ डेटा फिर से जनरेट कर सकते हैं. उदाहरण के लिए:

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

27 जून, 2019

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

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

1 नवंबर, 2018

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

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

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

17 सितंबर, 2018

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

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

    1. किसी तय समयावधि के दौरान, वीडियो या चैनल पर कम ट्रैफ़िक आया हो,

      या

    2. आपने ट्रैफ़िक सोर्स या देश जैसा कोई ऐसा फ़िल्टर या डाइमेंशन चुना है जिसकी वैल्यू तय थ्रेशोल्ड तक नहीं पहुंच पा रही है.

    नए सेक्शन में इस बारे में भी जानकारी दी गई है कि YouTube Analytics की रिपोर्ट में किस तरह का डेटा नहीं दिख सकता.

  • चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट से जुड़े दस्तावेज़ों को अपडेट कर दिया गया है. ऐसा इसलिए किया गया है, ताकि यह पता चल सके कि redViews और estimatedRedMinutesWatched मेट्रिक, वीडियो चलाने की जगह, ट्रैफ़िक सोर्स, और डिवाइस के टाइप/ऑपरेटिंग सिस्टम की रिपोर्ट के लिए अब काम नहीं करतीं.

18 जून, 2018

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

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

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

22 मई, 2018

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

  • नीचे दिए गए बदलाव जुलाई 2018 से लागू होंगे. नई नीतियां दुनिया भर की सभी रिपोर्ट और रिपोर्टिंग जॉब पर लागू होंगी.

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

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

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

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

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

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

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

26 अप्रैल, 2018

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

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

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

    इसके अलावा, v2 एपीआई में v1 की कुछ सुविधाएं काम नहीं करतीं:

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

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

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

21 फ़रवरी, 2018

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

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

18 जनवरी, 2018

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

  • YouTube Reporting API (एक साथ कई रिपोर्ट)

    • जिस डिवाइस पर व्यू मिले थे उसके सॉफ़्टवेयर सिस्टम की पहचान करने वाला operating_system डाइमेंशन, अब इस वैल्यू के साथ काम करता है:
      • 25: KaiOS

  • YouTube Analytics API (टारगेट की गई क्वेरी)

    • operatingSystem डाइमेंशन, डाइमेंशन वैल्यू KAIOS के साथ काम करता है.

20 दिसंबर, 2017

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

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

    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 गेमिंग
      • 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 के दर्शकों की संख्या से जुड़ी होती हैं. दरअसल, एपीआई ने कुछ समय से ही इन मेट्रिक के साथ काम किया है और 15 सितंबर, 2016 को की गई सूचना के मुताबिक, YouTube Reporting API पहले से ही दोनों मेट्रिक के साथ काम करता है.

    • 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: टिज़ेन
      • 23: फ़ायरफ़ॉक्स
      • 24: रीयलमीडिया

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

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

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 के YouTube 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 दिनों तक उपलब्ध रहेंगी.

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

    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 को हटा दिया गया है. (YouTube Reporting API में earnings मेट्रिक का इस्तेमाल कभी नहीं किया जा सकता.)

      • ad_type डाइमेंशन अब उस वैल्यू 19 के साथ काम करता है जो बंपर विज्ञापनों के बारे में है. ये बंपर विज्ञापन छह सेकंड तक की अवधि के स्किप नहीं किए जा सकते. ये वीडियो विज्ञापन, वीडियो देखे जाने से पहले चलते हैं.

    18 जुलाई, 2016

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

    • YouTube Analytics API (टारगेट की गई क्वेरी)

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

      • फ़िल्टर की सूचियों को चैनल पर दर्शक बनाए रखने की रिपोर्ट और कॉन्टेंट के मालिक की दर्शक बनाए रखने की रिपोर्ट, दोनों के लिए ठीक कर दिया गया है. इससे यह पता चलेगा कि video फ़िल्टर ज़रूरी है और group फ़िल्टर काम नहीं करता है.

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

    • YouTube Reporting API (एक साथ कई रिपोर्ट)

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

    28 जून, 2016

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

    ये मेट्रिक इस तरह की रिपोर्ट में इस्तेमाल की जा सकती हैं:

    22 जून, 2016

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

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

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

    • एपीआई, तीन रिपोर्ट के नए वर्शन के साथ काम करता है. उनमें से दो रिपोर्ट में नई और बदली गई मेट्रिक भी होती हैं:

      • content_owner_ad_rates_a1 रिपोर्ट, content_owner_ad_performance_a1 रिपोर्ट का नया वर्शन है. नए नाम वाली रिपोर्ट, पिछले वर्शन जैसी है.

      • नए वर्शन वाली दो रिपोर्ट के नाम बदले गए हैं:

        • content_owner_estimated_earnings_a1 रिपोर्ट के नए वर्शन का नाम content_owner_estimated_revenue_a1 है.
        • content_owner_asset_estimated_earnings_a1 रिपोर्ट के नए वर्शन का नाम content_owner_asset_estimated_revenue_a1 है.

        नई नाम वाली दोनों रिपोर्ट, पहले बनाई गई रिपोर्ट से इस तरह अलग हैं:

        • वे नई estimated_partner_red_revenue मेट्रिक जोड़ते हैं, जो YouTube Red के सदस्यों से हुई कुल कमाई का अनुमान लगाती है.
        • वे नई estimated_partner_transaction_revenue मेट्रिक जोड़ते हैं. इसमें, पैसे लेकर दिखाए जाने वाले कॉन्टेंट और फ़ैन फ़ंडिंग जैसे लेन-देन से मिलने वाले रेवेन्यू का अनुमान लगाया जाता है. इस मेट्रिक से, पार्टनर को दिए जाने वाले रिफ़ंड को घटा दिया जाता है.
        • वे estimated_partner_ad_sense_revenue मेट्रिक का नाम बदलकर estimated_partner_ad_auction_revenue कर देते हैं.
        • वे estimated_partner_double_click_revenue मेट्रिक का नाम बदलकर estimated_partner_ad_reserved_revenue कर देते हैं.

      ध्यान दें कि अगर आपके पास इन रिपोर्ट के पुराने वर्शन बनाने के लिए पहले से जॉब हैं, तो आपको नाम वाली रिपोर्ट के लिए नए जॉब बनाने होंगे. रिपोर्ट के नए वर्शन की रिलीज़ के साथ, content_owner_ad_performance_a1, content_owner_estimated_earnings_a1, और content_owner_asset_estimated_earnings_a1 रिपोर्ट बंद कर दी गई हैं.

      अगर आपके पास इनमें से किसी भी रिपोर्ट की नौकरी है, तो आपको उम्मीद नहीं करनी चाहिए कि YouTube 22 सितंबर, 2016 के बाद, इन नौकरियों के लिए नई रिपोर्ट जनरेट करेगा. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 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 इनबॉक्स
      • 84: Android मैसेंजर
    • YouTube Analytics API में, sharingService डाइमेंशन इन नई वैल्यू के साथ काम करता है:
      • ANDROID_MESSENGER: Android मैसेंजर
      • INBOX: Google इनबॉक्स
      • IOS_SYSTEM_ACTIVITY_DIALOG: iOS सिस्टम गतिविधि का डायलॉग बॉक्स

    16 मार्च, 2016

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

    YouTube रिपोर्टिंग एपीआई

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

    YouTube Analytics एपीआई

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

    8 फ़रवरी, 2016

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

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

    6 जनवरी, 2016

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

    • YouTube Reporting API में operating_system डाइमेंशन, 21 वैल्यू का इस्तेमाल करके Chromecast से मिले व्यू की पहचान करता है.
    • YouTube Analytics API में, Chromecast से मिले व्यू की पहचान करने के लिए operatingSystem डाइमेंशन, 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
      शून्य या उससे ज़्यादा का इस्तेमाल करें day, liveOrOnDemand, subscribedStatus, youtubeProduct
      मेट्रिक
      एक या उससे ज़्यादा वैल्यू का इस्तेमाल करें व्यू, estimatedMinutesWatched
      छनक:
      0 या 1 का इस्तेमाल करें देश, प्रांत, महाद्वीप, subContinent
      0 या 1 का इस्तेमाल करें वीडियो, ग्रुप
      शून्य या उससे ज़्यादा का इस्तेमाल करें 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 डाइमेंशन के दस्तावेज़ में सुधार कर दिया गया है. इसमें यह जानकारी दी गई है कि पैसिफ़िक समय के हिसाब से रात 12:00 बजे (यूटीसी-8) से शुरू होने वाली 24 घंटे की समयावधि के बारे में बताया गया है. इससे पहले, दस्तावेज़ में बताया गया था कि तारीख, दोपहर 12:00 बजे (जीएमटी) से शुरू हुई.

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

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

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

      एक ही रिपोर्ट को बार-बार प्रोसेस करने से रोकने के लिए, createdAfter पैरामीटर का इस्तेमाल करने का तरीका बताने के लिए, YouTube Reporting API के सबसे सही तरीके अपडेट कर दिए गए हैं.

    • job रिसॉर्स की createTime प्रॉपर्टी और report रिसॉर्स की startTime, endTime, और createTime प्रॉपर्टी की परिभाषाएं ठीक कर दी गई हैं, ताकि यह ध्यान दिया जा सके कि प्रॉपर्टी की वैल्यू, नैनोसेकंड के बजाय माइक्रोसेकंड के लिए सटीक हैं. इसके अलावा, अब सभी परिभाषाओं से पता चलता है कि प्रॉपर्टी की वैल्यू, टाइमस्टैंप है.

    8 अक्टूबर, 2015

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

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

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

    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 के बेचे जाने वाले विज्ञापन के सभी स्रोतों से होने वाली कुल अनुमानित आमदनी (कुल रेवेन्यू) शामिल होती है. यह मुख्य मेट्रिक नहीं है. एपीआई, earnings मेट्रिक के साथ काम करने वाली किसी भी रिपोर्ट के लिए, adEarnings मेट्रिक का इस्तेमाल करता है.

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

    • primaryAdGrossRevenue मेट्रिक अब काम नहीं करता. इसके बजाय, रेवेन्यू का डेटा पाने के लिए, grossRevenue मेट्रिक का इस्तेमाल करें.

    • अब काम नहीं करने वाली primaryAdGrossRevenue मेट्रिक के अलावा, विज्ञापन की परफ़ॉर्मेंस रिपोर्ट में monetizedPlaybacks और playbackBasedCpm मेट्रिक के साथ काम नहीं किया जा सकता. हालांकि, कई वीडियो रिपोर्ट में अब भी ये मेट्रिक काम करती हैं.

    1 जून, 2015

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

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

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

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

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

    31 मार्च, 2015

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

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

    16 मार्च, 2015

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

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

      पैरामीटर की वैल्यू, तीन अक्षरों वाला 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 तक उपलब्ध है.)

    • अब insightTrafficSourceType डाइमेंशन के लिए, GOOGLE_SEARCH को अलग वैल्यू के तौर पर रिपोर्ट नहीं किया जाता. इसके बजाय, Google पर खोज नतीजों से मिलने वाले रेफ़रल को अब EXT_URL ट्रैफ़िक सोर्स के तौर पर एट्रिब्यूट किया जाता है. इस वजह से, अब insightTrafficSourceType फ़िल्टर को GOOGLE_SEARCH पर सेट करने वाली insightTrafficSourceDetail रिपोर्ट को भी वापस नहीं लाया जा सकता.

    31 जनवरी, 2014

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

    16 जनवरी, 2014

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

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

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

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

      • अमेरिका के राज्यों और वॉशिंगटन डी.सी. के लिए, प्रांत के हिसाब से मेट्रिक: इस रिपोर्ट में, किसी चैनल के वीडियो को हर प्रांत के हिसाब से देखे जाने की संख्या और दूसरे आंकड़े मिलते हैं. इस डेटा में अमेरिका के राज्यों और वॉशिंगटन डी॰सी॰ के बारे में बताया गया है. इस उदाहरण में province डाइमेंशन का इस्तेमाल किया गया है. साथ ही, filters पैरामीटर का इस्तेमाल करके, रिस्पॉन्स को सिर्फ़ अमेरिका के नतीजे शामिल करने से रोका गया है.

      • कैलिफ़ोर्निया में दर्शकों की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह): इस रिपोर्ट में, कैलिफ़ोर्निया में रहने वाले दर्शकों के उम्र समूह और लिंग की जानकारी मिलती है. इनमें उन दर्शकों की जानकारी भी शामिल होती है जिन्होंने चैनल के वीडियो देखे हैं. इसके अलावा, कॉन्टेंट के मालिक की रिपोर्ट के हिसाब से, कॉन्टेंट के मालिक की ओर से दावा किए गए कॉन्टेंट से जुड़े आंकड़े भी मिलते हैं. इस उदाहरण में, filters पैरामीटर का इस्तेमाल करके यह पक्का किया गया है कि जवाब में सिर्फ़ किसी खास प्रांत का डेटा शामिल हो.

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

    6 जनवरी, 2014

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

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

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

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

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

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

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

          • मुख्य आंकड़ों की रिपोर्ट में कई आंकड़े होते हैं. जैसे, वीडियो देखे जाने की संख्या और वीडियो देखे जाने के अनुमानित मिनट.
          • समय-आधारित रिपोर्ट में एक जैसे आंकड़े होते हैं, लेकिन इसमें हर दिन, 7 दिन, 30 दिन या महीने के हिसाब से डेटा इकट्ठा किया जाता है.

        • किसी रिपोर्ट में सिर्फ़ किसी खास राज्य के आंकड़े शामिल करने के लिए, filters क्वेरी पैरामीटर का इस्तेमाल किया जा सकता है. कई रिपोर्ट में इस तरह का फ़िल्टर काम करता है. इनमें भौगोलिक रिपोर्ट, वीडियो चलाने की जगह की रिपोर्ट, ट्रैफ़िक सोर्स की रिपोर्ट, डिवाइस से जुड़ी रिपोर्ट, ऑपरेटिंग सिस्टम की रिपोर्ट, डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह) और सबसे लोकप्रिय वीडियो की रिपोर्ट शामिल हैं.

      • continent डाइमेंशन में संयुक्त राष्ट्र (यूएन) के आंकड़ों वाले क्षेत्र के कोड की जानकारी मिलती है. इस कोड से किसी महाद्वीप की पहचान होती है. इस डाइमेंशन का इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर किया जा सकता है.

      • subContinent डाइमेंशन, संयुक्त राष्ट्र (यूएन) के आंकड़ों वाले क्षेत्र के कोड के बारे में बताता है. इस कोड से महाद्वीप के उप-क्षेत्र की पहचान होती है. इस डाइमेंशन का इस्तेमाल सिर्फ़ फ़िल्टर के तौर पर भी किया जा सकता है.

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

    • दस्तावेज़ सही कर दिया गया है, ताकि insightTrafficSourceDetail डाइमेंशन में insightTrafficSourceType की वैल्यू PROMOTED, फ़िल्टर की मान्य वैल्यू के तौर पर शामिल न हो.

    30 सितंबर, 2013

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

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

    • एपीआई, अब insightPlaybackLocationType डाइमेंशन की वैल्यू के तौर पर EXTERNAL_APP के साथ काम करता है. इस अपडेट के बाद, 10 सितंबर, 2013 से, वीडियो को MOBILE की कैटगरी में नहीं चलाया जाएगा. हालांकि, इस तारीख से पहले मोबाइल पर चलने वाले वीडियो को भी इसी वैल्यू की कैटगरी में रखा जाएगा.

      इस अपडेट के बाद, मोबाइल पर चलाए जाने वाले वीडियो को अब WATCH, EMBEDDED या EXTERNAL_APP की कैटगरी में रखा जाएगा. यह इस बात पर निर्भर करेगा कि वीडियो किस तरह के ऐप्लिकेशन में चलाए जाते हैं.

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

    16 जुलाई, 2013

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

    • अब एपीआई की मदद से, कई डाइमेंशन और मेट्रिक के हिसाब से रिपोर्ट को क्रम से लगाया जा सकता है. सैंपल के अनुरोध वाले दस्तावेज़ में, अनुरोधों को एक से ज़्यादा डाइमेंशन/मेट्रिक के हिसाब से क्रम में लगाने का एक नया उदाहरण दिया गया है. इसमें यह फ़ंक्शन दिखाया गया है. अनुरोध, ट्रैफ़िक सोर्स का डेटा हासिल करता है और उसकी sort पैरामीटर वैल्यू day,-views है. नतीजों को समय के हिसाब से क्रम में लगाया जाता है, लेकिन हर दिन के लिए सेट किए गए नतीजे में, पहली लाइन में सबसे ज़्यादा व्यू जनरेट करने वाले ट्रैफ़िक सोर्स का डेटा होता है. दूसरी लाइन में उस सोर्स का डेटा होता है जिससे सबसे ज़्यादा व्यू जनरेट हुए.

    • यह एपीआई अब दो नए डाइमेंशन, deviceType और operatingSystem के साथ काम करता है. इसका इस्तेमाल करके उन डिवाइसों का डेटा हासिल किया जा सकता है जिन पर दर्शक आपके वीडियो देख रहे हैं. एपीआई ऐसी रिपोर्ट पर काम करता है जो दोनों में से किसी एक या दोनों डाइमेंशन का इस्तेमाल करती हैं.

      • deviceType रिपोर्ट की मदद से, अलग-अलग तरह के डिवाइसों पर वीडियो को मिले व्यू की संख्या और देखे जाने के अनुमानित समय की जानकारी पाई जा सकती है. इनमें डेस्कटॉप, मोबाइल, और टैबलेट डिवाइस शामिल हैं. डिवाइस टाइप रिपोर्ट में सिर्फ़ Android या iOS जैसे किसी खास ऑपरेटिंग सिस्टम का इस्तेमाल करने वाले डिवाइसों के आंकड़े शामिल करने के लिए, operatingSystem फ़िल्टर का इस्तेमाल किया जा सकता है.

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

    • नए शुरू करें सेक्शन में, YouTube Analytics API का इस्तेमाल करने वाला ऐप्लिकेशन बनाने से जुड़ी ज़रूरी शर्तों और बुनियादी चरणों के बारे में बताया गया है.

    12 सितंबर, 2012

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

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

    • अस्थायी डाइमेंशन सेक्शन को अपडेट किया गया है. इससे यह पता चलेगा कि इन डाइमेंशन का मतलब है कि Analytics की रिपोर्ट में, समयावधि के हिसाब से डेटा इकट्ठा किया जाना चाहिए. यह एपीआई अब समय के इन अतिरिक्त डाइमेंशन के साथ काम करता है:

      • 7DayTotals – रिपोर्ट के डेटा को इकट्ठा किया जाएगा, ताकि हर पंक्ति में सात दिन की अवधि का डेटा हो.
      • 30DayTotals – रिपोर्ट में मौजूद डेटा को एग्रीगेट किया जाएगा, ताकि हर लाइन में 30 दिन की अवधि का डेटा हो.
      • month – रिपोर्ट में मौजूद डेटा को कैलेंडर महीने के हिसाब से इकट्ठा किया जाएगा.

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

    • रिपोर्टिंग इकाई के डाइमेंशन सेक्शन को अपडेट किया गया है. इसमें यह बताया गया है कि कॉन्टेंट के मालिक की रिपोर्ट को फिर से पाने के लिए, एपीआई अनुरोधों को इनमें से किसी एक डाइमेंशन (video, channel या show) या claimedStatus और uploaderType डाइमेंशन के काम करने वाले कॉम्बिनेशन का इस्तेमाल करके, डेटा फ़िल्टर करना होगा.

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

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