इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

6 मई, 2024

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

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

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

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

7 अप्रैल, 2024

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

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

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

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

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

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

19 जनवरी, 2024

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

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

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

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

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

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

4 दिसंबर, 2023

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

15 दिसंबर, 2022

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

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

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

26 अगस्त, 2022

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

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

11 फ़रवरी, 2022

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

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

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

9 फ़रवरी, 2022

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

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

2 फ़रवरी, 2022

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

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

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

23 सितंबर, 2020

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

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

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

20 जुलाई, 2020

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

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

13 फ़रवरी, 2020

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

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

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

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

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

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

15 अक्टूबर, 2019

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

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

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

27 जून, 2019

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

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

1 नवंबर, 2018

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

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

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

17 सितंबर, 2018

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

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

18 जून, 2018

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

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

23 मई, 2018

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

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

22 मई, 2018

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

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

26 अप्रैल, 2018

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

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

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

21 फ़रवरी, 2018

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

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

18 जनवरी, 2018

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

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

20 दिसंबर, 2017

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

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

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

10 अगस्त, 2017

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

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

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

6 जुलाई, 2017

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

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

24 मई, 2017

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

content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1

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

22 मई, 2017

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

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

28 मार्च, 2017

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

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

17 मार्च, 2017

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

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

3 मार्च, 2017

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

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

8 फ़रवरी, 2017

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

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

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

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

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

15 दिसंबर, 2016

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

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

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

11 नवंबर, 2016

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

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

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

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

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

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

8 नवंबर, 2016

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

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

काम न करने वाली मेट्रिक	नई मेट्रिक
`adEarnings`	`estimatedAdRevenue`
`impressionBasedCpm`	`cpm`
`impressions`	`adImpressions`
`redPartnerRevenue`	`estimatedRedPartnerRevenue`

27 अक्टूबर, 2016

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

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

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

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

27 सितंबर, 2016

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

15 सितंबर, 2016

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

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

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

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

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

19 अगस्त, 2016

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

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

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

11 अगस्त, 2016

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

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

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

10 अगस्त, 2016

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

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

ध्यान दें: यह सुविधा बंद करने की घोषणा है.

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

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

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

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

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

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

18 जुलाई, 2016

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

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

28 जून, 2016

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

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

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

22 जून, 2016

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

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

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

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

19 मई, 2016

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

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

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

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

12 अप्रैल, 2016

इस अपडेट में नीचे दिए गए बदलाव शामिल हैं, जिनसे सिर्फ़ YouTube Reporting API पर असर पड़ेगा:

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

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

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

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

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

28 मार्च, 2016

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

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

16 मार्च, 2016

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

YouTube Reporting API

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

YouTube Analytics एपीआई

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

8 फ़रवरी, 2016

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

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

6 जनवरी, 2016

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

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

21 दिसंबर, 2015

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

18 दिसंबर, 2015

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

15 दिसंबर, 2015

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

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

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

विषय सूची

डाइमेंशन:

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

मेट्रिक

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

व्यू, estimatedMinutesWatched

छनक:

0 या 1 का इस्तेमाल करें	country, प्रांत, महाद्वीप, 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

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

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

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

29 अक्टूबर, 2015

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

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

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

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

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

8 अक्टूबर, 2015

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

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

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

24 सितंबर, 2015

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

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

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

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

20 अगस्त, 2015

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

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

22 जुलाई, 2015

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

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

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

1 जून, 2015

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

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

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

31 मार्च, 2015

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

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

16 मार्च, 2015

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

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

पैरामीटर की वैल्यू, तीन अक्षरों वाला 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 है, तो इसका मतलब है कि वह वीडियो, मिलती-जुलती अवधि वाले किसी भी दूसरे वीडियो के मुकाबले दर्शकों को ज़्यादा देर तक बनाए रखता है. वहीं, एक वैल्यू सबमिट करने का मतलब है कि वीडियो, मिलती-जुलती अवधि वाले किसी भी दूसरे वीडियो के मुकाबले ज़्यादा दर्शकों को बनाए रखता है. अगर मीडियन वैल्यू 0.5 है, तो इसका मतलब है कि मिलती-जुलती अवधि वाले आधे वीडियो बेहतर दर्शकों को चैनल पर बनाए रखते हैं. वहीं, आधे वीडियो खराब तरीके से दर्शकों को अपने चैनल पर बनाए रखते हैं.
audienceType फ़िल्टर का इस्तेमाल भी किया जा सकता है, ताकि रिपोर्ट सिर्फ़ ऑर्गैनिक व्यू, TrueView इन-स्ट्रीम विज्ञापनों के व्यू या TrueView इन-डिसप्ले विज्ञापनों से मिले व्यू से जुड़ा डेटा दिखाए. (ऑर्गैनिक व्यू, उपयोगकर्ता की कार्रवाई से होते हैं. जैसे, कोई वीडियो खोजना या सुझाए गए किसी वीडियो पर किया गया क्लिक.)
यह एपीआई, एनोटेशन से जुड़ी कई नई मेट्रिक के साथ काम करता है. नीचे दी गई मेट्रिक को ऐसी किसी भी रिपोर्ट से हासिल किया जा सकता है जो पहले annotationClickThroughRate और annotationCloseRate मेट्रिक के साथ काम करती थी.
- annotationImpressions: एनोटेशन इंप्रेशन की कुल संख्या.
- annotationClickableImpressions: दिखाई गई और क्लिक की जा सकने वाली व्याख्याओं की संख्या.
- annotationClosableImpressions: दिखाई गई और बंद की जा सकने वाली व्याख्याओं की संख्या.
- annotationClicks: क्लिक किए गए एनोटेशन की कुल संख्या.
- annotationCloses: बंद किए गए एनोटेशन की कुल संख्या.
सभी नई मेट्रिक, मुख्य मेट्रिक हैं और इन पर रोक लगाने की नीति लागू होती है. हालांकि, ध्यान दें कि नई मेट्रिक के लिए 16 जुलाई, 2013 से डेटा उपलब्ध है. (annotationClickThroughRate और annotationCloseRate मेट्रिक के लिए डेटा, 10 जून, 2012 से उपलब्ध है.)
insightTrafficSourceType डाइमेंशन के लिए, GOOGLE_SEARCH को अब अलग वैल्यू के तौर पर रिपोर्ट नहीं किया जाता. इसके बजाय, Google पर खोज नतीजों से मिलने वाले रेफ़रल को अब EXT_URL ट्रैफ़िक सोर्स टाइप के लिए एट्रिब्यूट किया जाएगा. इस वजह से, अब ऐसी insightTrafficSourceDetail रिपोर्ट को वापस नहीं लाया जा सकता जो insightTrafficSourceType फ़िल्टर को GOOGLE_SEARCH पर सेट करती है.

31 जनवरी, 2014

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

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

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

16 जनवरी, 2014

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

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

6 जनवरी, 2014

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

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

30 सितंबर, 2013

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

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

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

16 जुलाई, 2013

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

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

23 मई, 2013

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

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

10 मई, 2013

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

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

6 मई, 2013

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

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

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

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

3 मई, 2013

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

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

28 मार्च, 2013

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

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

21 मार्च, 2013

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

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

4 फ़रवरी, 2013

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

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

14 नवंबर, 2012

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

एपीआई रेफ़रंस गाइड में अब APIs Explorer शामिल है. इसकी मदद से, एपीआई को कॉल किया जा सकता है, एपीआई अनुरोध देखे जा सकते हैं, और रिस्पॉन्स में असली डेटा वापस पाया जा सकता है.
यह एपीआई, चैनलों और कॉन्टेंट के मालिकों दोनों के लिए कई नई रिपोर्ट की सुविधा देता है. इनकी जानकारी नीचे दी गई है. हर रिपोर्ट, चैनल की रिपोर्ट या कॉन्टेंट के मालिक की रिपोर्ट के तौर पर उपलब्ध होती है. डाइमेंशन और metrics पेजों को भी इसी हिसाब से अपडेट कर दिया गया है.
- वीडियो चलाने की जगह की रिपोर्ट से, अलग-अलग तरह के पेजों या ऐप्लिकेशन पर हुए वीडियो व्यू की संख्या का पता चलता है.
- वीडियो चलाने की जगह की ज़्यादा जानकारी वाली रिपोर्ट, एम्बेड किए गए उन प्लेयर की पहचान करती है जिन्होंने किसी खास वीडियो के लिए सबसे ज़्यादा व्यू जनरेट किए हैं. यह वीडियो चलाने की जगह की रिपोर्ट के मुकाबले, ज़्यादा बारीकी से जानकारी देने वाला व्यू देता है. इसके लिए, यह टॉप एम्बेड किए गए प्लेयर से जुड़े यूआरएल की पहचान करता है.
- ट्रैफ़िक सोर्स की रिपोर्ट से, अलग-अलग तरह के रेफ़रर से मिलने वाले वीडियो व्यू की संख्या का पता चलता है.
- ट्रैफ़िक सोर्स की ज़्यादा जानकारी वाली रिपोर्ट से, उन रेफ़रर की पहचान होती है जिन्होंने किसी वीडियो और किसी ट्रैफ़िक सोर्स के लिए सबसे ज़्यादा व्यू जनरेट किए. उदाहरण के लिए, इस रिपोर्ट से उन मिलते-जुलते वीडियो की जानकारी मिल सकती है जिनसे किसी वीडियो पर सबसे ज़्यादा ट्रैफ़िक आया है. यह रिपोर्ट, कई ट्रैफ़िक सोर्स के लिए काम करती है.
- वीडियो देखने के कुल समय की रिपोर्ट से पता चलता है कि दर्शकों ने आपका वीडियो कितनी देर तक देखा. रिपोर्ट में किसी खास समयावधि, दिन, पिछले सात दिनों, पिछले 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 metrics की परिभाषाएं अपडेट की गई हैं. इनसे यह पता चलता है कि किसी चैनल के सदस्यों की संख्या कई जगहों पर बढ़ या घट सकती है. इनमें वीडियो के वॉच पेज, चैनल पेज, और YouTube के होम पेज पर दिखने वाली गाइड शामिल है. जब ये मेट्रिक, किसी वीडियो से जुड़ी रिपोर्ट में दिखती हैं, तो इनमें सिर्फ़ खास वीडियो के वॉच पेज से जुड़े आंकड़े शामिल होते हैं.