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

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

15 नवंबर, 2024

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

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

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

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

6 मई, 2024

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

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

  • एक साथ देख रहे दर्शकों की रिपोर्ट से, लाइव स्ट्रीम किए गए किसी वीडियो के अलग-अलग हिस्सों को एक साथ देखने वाले दर्शकों की संख्या का पता चलता है.

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

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

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

7 अप्रैल, 2024

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

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

  • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

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

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

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

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

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

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

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

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

19 जनवरी, 2024

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

  • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

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

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

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

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

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

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

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

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

4 दिसंबर, 2023

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

15 दिसंबर, 2022

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

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

  • नए 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 पर सेट किया जा सकता है. इससे पता चलता है कि ट्रैफ़िक, Podcasts के डेस्टिनेशन पेज से रेफ़र किया गया था.
  • YouTube रिपोर्टिंग (बल्क रिपोर्ट) एपीआई में, अगर traffic_source_type डाइमेंशन की वैल्यू 3 है, तो traffic_source_detail वैल्यू को podcasts पर सेट किया जा सकता है. इससे पता चलता है कि ट्रैफ़िक, पॉडकास्ट डेस्टिनेशन पेज से रेफ़र किया गया था.

11 फ़रवरी, 2022

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

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

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

9 फ़रवरी, 2022

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

2 फ़रवरी, 2022

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

  • YouTube Reporting (Bulk Reports) API में, traffic_source_type डाइमेंशन में वैल्यू 28 का इस्तेमाल किया जा सकता है.

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

23 सितंबर, 2020

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

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

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

20 जुलाई, 2020

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

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

13 फ़रवरी, 2020

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

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

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

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

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

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

15 अक्टूबर, 2019

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

  • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

27 जून, 2019

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

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

1 नवंबर, 2018

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

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

    ध्यान दें कि इस सुविधा के बंद होने की तारीख का एलान 26 अप्रैल, 2018 को किया गया था.

17 सितंबर, 2018

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

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

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

      या

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

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

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

18 जून, 2018

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

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

      पहले विकल्प में एक स्कोप का इस्तेमाल किया जाता है, जो रीड-राइट स्कोप होता है. वहीं, दूसरे विकल्प में दो रीड-ओनली स्कोप का इस्तेमाल किया जाता है.

23 मई, 2018

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

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

22 मई, 2018

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

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

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

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

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

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

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

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

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

26 अप्रैल, 2018

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

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

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

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

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

  • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

21 फ़रवरी, 2018

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

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

18 जनवरी, 2018

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

  • YouTube Reporting API (बल्क रिपोर्ट)

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

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

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

20 दिसंबर, 2017

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

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

    gzip से एन्कोड किया गया रिस्पॉन्स पाने के लिए, Accept-Encoding एचटीटीपी अनुरोध हेडर को gzip पर सेट करें, जैसा कि यहां दिए गए उदाहरण में दिखाया गया है:

    Accept-Encoding: gzip

    इस फ़ंक्शन के बारे में एपीआई की खास जानकारी और report रिसॉर्स की downloadUrl प्रॉपर्टी की परिभाषा में बताया गया है.

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

    • age_group डाइमेंशन की वैल्यू में अपरकेस अक्षरों का इस्तेमाल किया जाता है. साथ ही, उम्र समूह के शब्द AGE और संख्याओं के बीच अंडरस्कोर होते हैं. साथ ही, हाइफ़न के बजाय अंडरस्कोर का इस्तेमाल किया जाता है. इसलिए, age13-17 और age18-24 जैसी वैल्यू को क्रमशः AGE_13_17 और AGE_18_24 में बदल दिया गया है.
    • gender डाइमेंशन की वैल्यू के लिए, अंग्रेज़ी के बड़े अक्षरों का इस्तेमाल किया जाता है. इसलिए, female, male, और gender_other की वैल्यू को FEMALE, MALE, और GENDER_OTHER में बदल दिया गया है.

10 अगस्त, 2017

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

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

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

6 जुलाई, 2017

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

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

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

      उदाहरण के लिए, अगर किसी अनुरोध में खत्म होने की तारीख 5 जुलाई, 2017 दी गई है और अनुरोध की गई सभी मेट्रिक की वैल्यू सिर्फ़ 3 जुलाई, 2017 तक उपलब्ध हैं, तो वह तारीख ही जवाब में शामिल डेटा की आखिरी तारीख होगी. (यह तब भी सही है, जब अनुरोध की गई कुछ मेट्रिक का डेटा 4 जुलाई, 2017 के लिए उपलब्ध हो.)

    • adType डाइमेंशन में अब reservedBumperInstream वैल्यू का इस्तेमाल किया जा सकता है. यह वैल्यू, स्किप नहीं किए जा सकने वाले ऐसे वीडियो विज्ञापन के बारे में बताती है जो छह सेकंड तक चलता है. यह विज्ञापन, वीडियो देखने से पहले चलता है. यह विज्ञापन फ़ॉर्मैट, auctionBumperInstream विज्ञापन से मिलता-जुलता है. हालांकि, इस टाइप में नीलामी के बजाय, रिज़र्व किए गए विज्ञापनों की बिक्री की जाती है.

  • YouTube Reporting API (बल्क रिपोर्ट)

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

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

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

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

24 मई, 2017

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

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

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

22 मई, 2017

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

  • YouTube Reporting API (बल्क रिपोर्ट)

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

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      इसके अलावा, दस्तावेज़ में वैल्यू 52 की पहचान करने के लिए इस्तेमाल किए गए नाम को Kakao (Kakao Talk) में अपडेट किया गया है, ताकि इसे वैल्यू 73 (Kakao Story) से साफ़ तौर पर अलग किया जा सके. इस बदलाव से, एपीआई के काम करने के तरीके या इन सेवाओं के साथ शेयर किए गए वीडियो की कैटगरी में कोई बदलाव नहीं होगा.

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

    • sharingService डाइमेंशन में अब ये वैल्यू इस्तेमाल की जा सकती हैं:

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

28 मार्च, 2017

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

17 मार्च, 2017

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

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

    • redViews मेट्रिक से पता चलता है कि YouTube Red के सदस्यों ने किसी वीडियो को कितनी बार देखा.
    • estimatedRedMinutesWatched मेट्रिक से पता चलता है कि YouTube Red के सदस्यों ने किसी वीडियो को कितने मिनट तक देखा.

    चैनल रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट के दस्तावेज़ को अपडेट किया गया है. इससे यह पता चलता है कि कौनसी रिपोर्ट में दो नई मेट्रिक काम करती हैं. ये उन सभी रिपोर्ट में काम करती हैं जिनमें पहले से ही views और estimatedMinutesWatched मेट्रिक काम करती हैं.

3 मार्च, 2017

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

  • YouTube Reporting API (बल्क रिपोर्ट)

    • date डाइमेंशन की परिभाषा में बदलाव किया गया है. इससे यह पता चलता है कि डाइमेंशन की वैल्यू, तय किए गए दिन, महीने, और साल के पैसिफ़िक टाइम के मुताबिक, सुबह 12:00 बजे से रात 11:59 बजे तक की अवधि के बारे में बताती है. साल के समय के हिसाब से, पैसिफ़िक टाइम, यूटीसी-7 या यूटीसी-8 होता है.

      आम तौर पर, तारीखों से 24 घंटे की अवधि का पता चलता है. हालांकि, जब घड़ियों को आगे बढ़ाया जाता है, तो तारीखों से 23 घंटे की अवधि का पता चलता है. वहीं, जब घड़ियों को पीछे बढ़ाया जाता है, तो तारीखों से 25 घंटे की अवधि का पता चलता है. (पहले, दस्तावेज़ में बताया गया था कि हर तारीख, 24 घंटे की एक खास अवधि को दिखाती है और पैसिफ़िक टाइम हमेशा UTC-8 होता है.)

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

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

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

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

    • time periods से जुड़े डाइमेंशन की जानकारी में बदलाव किया गया है. इसमें बताया गया है कि डाइमेंशन की वैल्यू, तय किए गए दिन, महीने, और साल को पैसिफ़िक टाइम के मुताबिक सुबह 12:00 बजे से रात 11:59 बजे तक की अवधि के बारे में बताती है. साल के समय के हिसाब से, पैसिफ़िक टाइम, यूटीसी-7 या यूटीसी-8 होता है.

      आम तौर पर, तारीखों से 24 घंटे की अवधि का पता चलता है. हालांकि, जब घड़ियों को आगे बढ़ाया जाता है, तो तारीखों से 23 घंटे की अवधि का पता चलता है. वहीं, जब घड़ियों को पीछे बढ़ाया जाता है, तो तारीखों से 25 घंटे की अवधि का पता चलता है. (पहले, दस्तावेज़ में बताया गया था कि पैसिफ़िक टाइम, यूटीसी-8 था. साथ ही, इस बात का ज़िक्र नहीं किया गया था कि एक दिन में 24 घंटे नहीं हो सकते.)

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

    • चैनल रिपोर्ट के दस्तावेज़ को अपडेट किया गया है. इसमें बताया गया है कि फ़िलहाल, चैनल रिपोर्ट में आय या विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक शामिल नहीं हैं. इसलिए, https://www.googleapis.com/auth/yt-analytics-monetary.readonly स्कोप में फ़िलहाल, चैनल रिपोर्ट में मौजूद पैसों से जुड़े डेटा का ऐक्सेस नहीं मिलता.

    • operatingSystem डाइमेंशन में, डाइमेंशन की तीन नई वैल्यू इस्तेमाल की जा सकती हैं:
      • FIREFOX
      • REALMEDIA
      • TIZEN

8 फ़रवरी, 2017

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

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

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

  • अगर पैरामीटर की वैल्यू false है, तो किसी चैनल के लिए वॉच टाइम और व्यू का डेटा, उस चैनल को कॉन्टेंट के मालिक से लिंक करने की तारीख पर आधारित होता है.

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

15 दिसंबर, 2016

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

  • चैनल की रिपोर्ट

    • channel_basic_a1 - इसे channel_basic_a2 रिपोर्ट से बदल दिया गया है.
    • channel_province_a1 - इसे channel_province_a2 रिपोर्ट से बदल दिया गया है.
    • channel_playback_location_a1 - इसे channel_playback_location_a2 रिपोर्ट से बदल दिया गया है.
    • channel_traffic_source_a1 - इसे channel_traffic_source_a2 रिपोर्ट से बदल दिया गया है.
    • channel_device_os_a1 - इसे channel_device_os_a2 रिपोर्ट से बदल दिया गया है.
    • channel_subtitles_a1 - इसे channel_subtitles_a2 रिपोर्ट से बदल दिया गया है.
    • channel_combined_a1 - इसे channel_combined_a2 रिपोर्ट से बदल दिया गया है.

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

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

11 नवंबर, 2016

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

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

    • एंड स्क्रीन रिपोर्ट

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

    • एंड स्क्रीन के डाइमेंशन

      • end_screen_element_type: आंकड़ों से जुड़े एंड स्क्रीन एलिमेंट का टाइप.
      • end_screen_element_id: यह एक आईडी है. इसका इस्तेमाल करके, YouTube एंड स्क्रीन एलिमेंट की खास पहचान करता है.

    • एंड स्क्रीन की मेट्रिक

      ध्यान दें: एंड स्क्रीन मेट्रिक का डेटा, 1 मई, 2016 से उपलब्ध है.

      • end_screen_element_impressions: एंड स्क्रीन एलिमेंट पर मिले इंप्रेशन की कुल संख्या. एंड स्क्रीन पर दिखने वाले हर एलिमेंट के लिए, एक इंप्रेशन लॉग किया जाता है.
      • end_screen_element_clicks: एंड स्क्रीन के एलिमेंट पर क्लिक किए जाने की संख्या.
      • end_screen_element_click_rate: एंड स्क्रीन एलिमेंट पर क्लिक मिलने की दर.

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

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

    8 नवंबर, 2016

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

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

      बंद की गई मेट्रिक नई मेट्रिक
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    27 अक्टूबर, 2016

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

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

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

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

    27 सितंबर, 2016

    ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

    15 सितंबर, 2016

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

    • एपीआई, YouTube Red की सदस्यता वाले दर्शकों से जुड़ी दो नई मेट्रिक के साथ काम करता है:

      • red_views: YouTube Red के सदस्यों ने किसी वीडियो को कितनी बार देखा.
      • red_watch_time_minutes: YouTube Red के सदस्यों ने वीडियो को कितने मिनट तक देखा.

    • एपीआई, 20 रिपोर्ट के नए वर्शन के साथ काम करता है. सभी नए वर्शन, नई red_views और red_watch_time_minutes मेट्रिक के साथ काम करते हैं.

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

      यहां दी गई सूचियों में, रिपोर्ट टाइप के नए आईडी की पहचान की गई है:

    • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      अगर आपने इनमें से किसी भी रिपोर्ट के लिए जॉब सेट की हैं, तो आपको 15 दिसंबर, 2016 के बाद, YouTube से उन जॉब के लिए नई रिपोर्ट जनरेट होने की उम्मीद नहीं करनी चाहिए. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहेंगी.

    19 अगस्त, 2016

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

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

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

    11 अगस्त, 2016

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

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

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

    10 अगस्त, 2016

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

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

      • ध्यान दें: यह, हटाए गए टैग और एट्रिब्यूट से जुड़ी सूचना है.

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

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

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

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

      • insightTrafficSourceType डाइमेंशन में, डाइमेंशन की दो नई वैल्यू इस्तेमाल की जा सकती हैं:
        • CAMPAIGN_CARD: यह ट्रैफ़िक सोर्स, सिर्फ़ कॉन्टेंट के मालिक की शिकायतों के लिए काम करता है. इससे पता चलता है कि ये व्यू, उपयोगकर्ताओं के अपलोड किए गए उन वीडियो से मिले हैं जिन पर दावा किया गया है. कॉन्टेंट के मालिक ने इन वीडियो का इस्तेमाल, देखे गए कॉन्टेंट का प्रमोशन करने के लिए किया था.
        • END_SCREEN: यह डेटा, किसी दूसरे वीडियो की एंडस्क्रीन से मिले व्यू से जुड़ा होता है.

        दोनों नए ट्रैफ़िक सोर्स के लिए, traffic source detail रिपोर्ट भी देखी जा सकती है. दोनों ही मामलों में, insightTrafficSourceDetail डाइमेंशन उस वीडियो की पहचान करता है जिससे दर्शक को रेफ़र किया गया था.

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

    • YouTube Reporting API (बल्क रिपोर्ट)

      • traffic_source_type डाइमेंशन में अब ये वैल्यू इस्तेमाल की जा सकती हैं:
        • 19: यह ट्रैफ़िक सोर्स, सिर्फ़ कॉन्टेंट के मालिक की शिकायतों के लिए काम करता है. इससे पता चलता है कि ये व्यू, उपयोगकर्ताओं के अपलोड किए गए उन वीडियो से मिले हैं जिन पर दावा किया गया है. कॉन्टेंट के मालिक ने इन वीडियो का इस्तेमाल, देखे गए कॉन्टेंट का प्रमोशन करने के लिए किया था.
        • 20: यह डेटा, किसी दूसरे वीडियो की एंडस्क्रीन से मिले व्यू से जुड़ा होता है.

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

      • एपीआई की कोर मेट्रिक की सूची में बदलाव किया गया है. इसमें estimated_partner_revenue को कोर मेट्रिक के तौर पर शामिल किया गया है और earnings को उस सूची से हटा दिया गया है. (earnings मेट्रिक, YouTube Reporting API में कभी काम नहीं करती.)

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

    18 जुलाई, 2016

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

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

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

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

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

    • YouTube Reporting API (बल्क रिपोर्ट)

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

    28 जून, 2016

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

    ये मेट्रिक, इन तरह की रिपोर्ट में काम करती हैं:

    22 जून, 2016

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

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

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

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

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

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

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

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

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

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

      अगर आपने इनमें से किसी भी रिपोर्ट के लिए नौकरियां पोस्ट की हैं, तो आपको 22 सितंबर, 2016 के बाद, YouTube से उन नौकरियों के लिए नई रिपोर्ट जनरेट होने की उम्मीद नहीं करनी चाहिए. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहेंगी.

    • उपलब्ध रिपोर्ट के मौजूदा सेट को दिखाने के लिए, reportType रिसॉर्स की id प्रॉपर्टी की परिभाषा को अपडेट किया गया है.

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

      • estimated_partner_adsense_revenue मेट्रिक का नाम बदलकर estimated_partner_ad_sense_revenue कर दिया गया है. हालांकि, ध्यान दें कि यह मेट्रिक सिर्फ़ दो रिपोर्ट में दिखती है, जिन्हें इस अपडेट के साथ बंद किया जा रहा है. जैसा कि ऊपर बताया गया है, इन रिपोर्ट के नए वर्शन में इस मेट्रिक का नाम बदलकर estimated_partner_ad_auction_revenue कर दिया गया है.
      • estimated_partner_doubleclick_revenue मेट्रिक का नाम बदलकर estimated_partner_double_click_revenue कर दिया गया है. फिर से ध्यान दें कि यह मेट्रिक सिर्फ़ दो रिपोर्ट में दिखती है, जिन्हें इस अपडेट के साथ बंद किया जा रहा है. जैसा कि ऊपर बताया गया है, इन रिपोर्ट के नए वर्शन में इस मेट्रिक का नाम बदलकर estimated_partner_ad_reserved_revenue कर दिया गया है.

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

    19 मई, 2016

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

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

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

      नई रिपोर्ट के रिलीज़ होने के साथ ही, content_owner_basic_a1 रिपोर्ट को बंद कर दिया गया है. अगर आपने उस रिपोर्ट के लिए कोई जॉब सेट किया है, तो आपको 19 अगस्त, 2016 के बाद, YouTube से उस जॉब के लिए नई रिपोर्ट जनरेट होने की उम्मीद नहीं करनी चाहिए. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिनों तक उपलब्ध रहेंगी.

    • reportType, job, और report संसाधन, सभी एक नई प्रॉपर्टी के साथ काम करते हैं. इससे यह पता चलता है कि उससे जुड़ा संसाधन, इस्तेमाल में न होने वाली रिपोर्ट टाइप को दिखाता है या नहीं:

      • reportType रिसॉर्स की deprecateTime प्रॉपर्टी से पता चलता है कि रिपोर्ट टाइप को कब बंद किया जाएगा. इस प्रॉपर्टी में सिर्फ़ उन रिपोर्ट की वैल्यू होती है जिन्हें बंद करने का एलान किया गया है. साथ ही, इस वैल्यू से उस तारीख का पता चलता है जब YouTube उस टाइप की रिपोर्ट जनरेट करना बंद कर देगा.

        किसी रिपोर्ट टाइप के बंद होने का एलान करने के बाद, YouTube उस टाइप की रिपोर्ट तीन महीने तक जनरेट करता है. उदाहरण के लिए, 19 मई, 2016 को किए गए इस अपडेट में, content_owner_basic_a1 रिपोर्ट के बंद होने की जानकारी दी गई है. इसलिए, उस रिपोर्ट टाइप के लिए deprecateTime में 19 अगस्त, 2016 का समय बताया गया है. इसके बाद, YouTube उस टाइप की रिपोर्ट जनरेट करना बंद कर देगा.

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

      • report रिसॉर्स की jobExpireTime प्रॉपर्टी से यह पता चलता है कि रिपोर्ट से जुड़ी नौकरी की समयसीमा कब खत्म हो गई या कब खत्म होगी. इस प्रॉपर्टी में वही वैल्यू होती है जो job रिसॉर्स में expireTime प्रॉपर्टी में होती है. इस बारे में इस सूची के पिछले आइटम में बताया गया है.

    • अगर किसी बंद की गई रिपोर्ट के लिए जॉब बनाने की कोशिश की जाती है, तो jobs.create तरीका अब 400 एचटीटीपी रिस्पॉन्स कोड (Bad Request) दिखाता है. इसके अलावा, इस तरीके के दस्तावेज़ में अब कई अन्य वजहें बताई गई हैं जिनकी वजह से एपीआई अनुरोध पूरा नहीं हो पाता.

    12 अप्रैल, 2016

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

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

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

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

      इन सभी बदलावों के बारे में, Reporting API की खास जानकारी वाले नए पुराने डेटा सेक्शन में बताया गया है.

    • YouTube Reporting API की खास जानकारी वाले रिपोर्ट की विशेषताएं सेक्शन को अपडेट किया गया है. इसमें ये बदलाव किए गए हैं:

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

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

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

      सिस्टम से मैनेज की जाने वाली रिपोर्ट लॉन्च करने की तैयारी के तौर पर, एपीआई में होने वाले इन बदलावों का एलान किया जा रहा है:

      • job रिसॉर्स की नई systemManaged प्रॉपर्टी से पता चलता है कि रिसॉर्स में ऐसी जॉब के बारे में बताया गया है या नहीं जो सिस्टम से मैनेज की जाने वाली रिपोर्ट जनरेट करती है. YouTube, कॉन्टेंट के मालिकों के लिए सिस्टम से मैनेज की जाने वाली रिपोर्ट अपने-आप जनरेट करता है. कॉन्टेंट के मालिक, उन रिपोर्ट को जनरेट करने वाली जॉब में बदलाव नहीं कर सकते या उन्हें मिटा नहीं सकते.

      • jobs.list तरीके के नए includeSystemManaged पैरामीटर से पता चलता है कि एपीआई के जवाब में, सिस्टम से मैनेज की जाने वाली रिपोर्ट के लिए जॉब शामिल होने चाहिए या नहीं. पैरामीटर की डिफ़ॉल्ट वैल्यू false है.

      • jobs.reports.list तरीके के नए startTimeAtOrAfter पैरामीटर से पता चलता है कि एपीआई के जवाब में सिर्फ़ ऐसी रिपोर्ट शामिल होनी चाहिए जिनमें सबसे पुराना डेटा, तय की गई तारीख या उसके बाद का हो. इसी तरह, startTimeBefore पैरामीटर से पता चलता है कि एपीआई के जवाब में सिर्फ़ ऐसी रिपोर्ट शामिल होनी चाहिए जिनमें सबसे पुराना डेटा, तय की गई तारीख से पहले का हो.

        नए पैरामीटर, रिपोर्ट में मौजूद डेटा से जुड़े होते हैं. ये पैरामीटर, रिपोर्ट बनाने के समय से जुड़े पैरामीटर createdAfter से अलग होते हैं.

      • reportType रिसॉर्स की नई systemManaged प्रॉपर्टी से पता चलता है कि रिसॉर्स में, सिस्टम से मैनेज की जाने वाली रिपोर्ट के बारे में बताया गया है या नहीं.

      • reportTypes.list तरीके के नए includeSystemManaged पैरामीटर से पता चलता है कि एपीआई के रिस्पॉन्स में, सिस्टम से मैनेज की जाने वाली रिपोर्ट शामिल होनी चाहिए या नहीं. पैरामीटर की डिफ़ॉल्ट वैल्यू false है.

    28 मार्च, 2016

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

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

    16 मार्च, 2016

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

    YouTube Reporting API

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

    YouTube Analytics API

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

    8 फ़रवरी, 2016

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

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

    6 जनवरी, 2016

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

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

    21 दिसंबर, 2015

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

    18 दिसंबर, 2015

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

    15 दिसंबर, 2015

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

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

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

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

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

      कॉन्टेंट
      डाइमेंशन:
      ज़रूरी है deviceType
      0 या उससे ज़्यादा का इस्तेमाल करें day, liveOrOnDemand, subscribedStatus, youtubeProduct
      मेट्रिक
      एक या उससे ज़्यादा का इस्तेमाल करें व्यू, estimatedMinutesWatched
      छनक:
      0 या 1 का इस्तेमाल करें देश, प्रांत, महाद्वीप, subContinent
      0 या 1 का इस्तेमाल करें वीडियो, ग्रुप
      0 या उससे ज़्यादा का इस्तेमाल करें operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

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

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

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

    • अगर किसी खाली YouTube Analytics group के लिए डेटा का अनुरोध किया जाता है, तो एपीआई अब गड़बड़ी के बजाय खाली डेटा सेट दिखाता है.

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

    • YouTube Analytics API के groups.list तरीके में अब पेजेशन की सुविधा काम करती है. अगर एपीआई के रिस्पॉन्स में सभी उपलब्ध ग्रुप शामिल नहीं हैं, तो रिस्पॉन्स के nextPageToken पैरामीटर में एक टोकन होता है. इसका इस्तेमाल, नतीजों के अगले पेज को वापस लाने के लिए किया जा सकता है. ज़्यादा नतीजे पाने के लिए, उस वैल्यू पर तरीके के pageToken पैरामीटर को सेट करें.

    10 नवंबर, 2015

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

    29 अक्टूबर, 2015

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

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

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

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

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

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

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

    8 अक्टूबर, 2015

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

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

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

    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

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

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

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

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

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

    31 मार्च, 2015

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

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

    16 मार्च, 2015

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

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

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

    25 फ़रवरी, 2015

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

    • एपीआई की मदद से, अब YouTube Analytics ग्रुप बनाए जा सकते हैं और उन्हें मैनेज किया जा सकता है. साथ ही, उन ग्रुप के लिए रिपोर्ट का डेटा भी वापस पाया जा सकता है.

      • ग्रुप बनाना और उन्हें मैनेज करना

        इस अपडेट में, ग्रुप बनाने और उन्हें मैनेज करने के लिए group और groupItem संसाधनों को शामिल किया गया है.

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

        उदाहरण के लिए, groups.insert तरीके का इस्तेमाल करके ग्रुप बनाया जा सकता है. इसके बाद, groupItems.insert तरीके का इस्तेमाल करके उस ग्रुप में आइटम जोड़े जा सकते हैं.

      • किसी ग्रुप के लिए रिपोर्ट का डेटा पाना

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

      YouTube Analytics के ग्रुप के बारे में ज़्यादा जानने के लिए, YouTube सहायता केंद्र पर जाएं.

    13 फ़रवरी, 2015

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

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

    28 अगस्त, 2014

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

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

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

      इस फ़ंक्शन के बारे में पूरी जानकारी के लिए, filters पैरामीटर की परिभाषा देखें.

    16 जुलाई, 2014

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

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

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

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

      इसके अलावा, सभी प्लेलिस्ट रिपोर्ट में ये नई मेट्रिक काम करती हैं. ध्यान दें कि इनमें से हर मेट्रिक से, सिर्फ़ वेब पर प्लेलिस्ट के व्यू की जानकारी मिलती है.

      • playlistStarts: दर्शकों की तरफ़ से किसी वीडियो सूची के वीडियो चलाए जाने की संख्या.
      • viewsPerPlaylistStart: हर बार प्लेलिस्ट शुरू करने पर, वीडियो के औसत व्यू की संख्या.
      • averageTimeInPlaylist: प्लेलिस्ट शुरू करने के बाद, दर्शक ने प्लेलिस्ट में वीडियो देखने में बिताया गया अनुमानित औसत समय (मिनट में).

      प्लेलिस्ट की रिपोर्ट पाने के लिए किए गए किसी भी अनुरोध में, isCurated फ़िल्टर का इस्तेमाल करना ज़रूरी है. साथ ही, यह फ़िल्टर 1 (isCurated==1) पर सेट होना चाहिए.

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

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

        ध्यान दें कि किसी वीडियो के किसी हिस्से को एक से ज़्यादा बार देखा जा सकता है या उसे कभी नहीं देखा जा सकता. उदाहरण के लिए, अगर उपयोगकर्ता किसी वीडियो के एक ही हिस्से को कई बार देखकर उसे रीवाइंड करते हैं, तो वीडियो के उस हिस्से का कुल अनुपात 1 से ज़्यादा हो सकता है.

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

      audienceType फ़िल्टर का इस्तेमाल करके भी, रिपोर्ट में सिर्फ़ ऑर्गैनिक व्यू, TrueView इन-स्ट्रीम विज्ञापनों से मिले व्यू या TrueView इन-डिसप्ले विज्ञापनों से मिले व्यू का डेटा देखा जा सकता है. (ऑर्गैनिक व्यू, उपयोगकर्ता की कार्रवाई का सीधा नतीजा होते हैं. जैसे, वीडियो खोजना या सुझाए गए वीडियो पर क्लिक करना.)

    • एपीआई, एनोटेशन से जुड़ी कई नई मेट्रिक के साथ काम करता है. यहां दी गई मेट्रिक, उन सभी रिपोर्ट से वापस पाई जा सकती हैं जिनमें पहले annotationClickThroughRate और annotationCloseRate मेट्रिक काम करती थीं.

      • annotationImpressions: एनोटेशन के इंप्रेशन की कुल संख्या.
      • annotationClickableImpressions: उन एनोटेशन की संख्या जो दिखे और जिन पर क्लिक किया जा सका.
      • annotationClosableImpressions: उन एनोटेशन की संख्या जो दिखे और जिन्हें बंद किया जा सका.
      • annotationClicks: क्लिक किए गए एनोटेशन की कुल संख्या.
      • annotationCloses: बंद किए गए एनोटेशन की कुल संख्या.

      सभी नई मेट्रिक, मुख्य मेट्रिक हैं और अमान्य होने की नीति के दायरे में आती हैं. हालांकि, ध्यान दें कि नई मेट्रिक के लिए डेटा 16 जुलाई, 2013 से उपलब्ध है. (annotationClickThroughRate और annotationCloseRate मेट्रिक का डेटा 10 जून, 2012 से उपलब्ध है.)

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

    31 जनवरी, 2014

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

    16 जनवरी, 2014

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

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

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

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

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

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

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

    6 जनवरी, 2014

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

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

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

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

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

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

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

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

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

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

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

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

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

    30 सितंबर, 2013

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

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

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

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

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

    16 जुलाई, 2013

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

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

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

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

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

      डिवाइस के टाइप और ऑपरेटिंग सिस्टम की नई रिपोर्ट, चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं.

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

    • insightPlaybackLocationType डाइमेंशन, YT_OTHER वैल्यू दिखा सकता है. इससे उन व्यू की पहचान की जा सकती है जिन्हें डाइमेंशन की किसी अन्य वैल्यू का इस्तेमाल करके, कैटगरी में नहीं रखा गया है.

    23 मई, 2013

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

    10 मई, 2013

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

    6 मई, 2013

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

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