इस पेज पर, YouTube Reporting API और YouTube Analytics API, दोनों के लिए एपीआई में हुए बदलावों और दस्तावेज़ों से जुड़े अपडेट की सूची दी गई है. दोनों एपीआई, डेवलपर को YouTube Analytics का डेटा ऐक्सेस करने की सुविधा देते हैं. हालांकि, ऐसा वे अलग-अलग तरीकों से करते हैं. बदलाव लॉग की सदस्यता लें.
04 दिसंबर, 2023
YouTube Analytics (टारगेट की गई क्वेरी) एपीआई को अपडेट किया गया है. इसे insightTrafficSourceType
डाइमेंशन की दो वैल्यू को मर्ज करने के लिए अपडेट किया गया है. पहले, किसी प्लेलिस्ट (PLAYLIST
) के हिस्से के तौर पर चलाए गए वीडियो और किसी ऐसे पेज से मिले व्यू की संख्या के बीच अंतर होता था
जिसमें किसी प्लेलिस्ट के सभी वीडियो की सूची होती है
(YT_PLAYLIST_PAGE
). इसके बाद, दोनों तरह के व्यू,
PLAYLIST
की डाइमेंशन वैल्यू के साथ जोड़े जाएंगे.
15 दिसंबर, 2022
YouTube Analytics (टारगेट की गई क्वेरी) एपीआई, दो नए डाइमेंशन और एक नई रिपोर्ट के साथ काम करता है:
-
नई रिपोर्ट में, शहर के हिसाब से उपयोगकर्ता की गतिविधि की जानकारी मिलती है. यह रिपोर्ट, चैनल और कॉन्टेंट के मालिकों के लिए उपलब्ध है. इस रिपोर्ट में नया
city
डाइमेंशन शामिल है. इससे YouTube के अनुमान के आधार पर यह पता चलता है कि उपयोगकर्ता ने किस शहर में गतिविधि की. -
creatorContentType
का नया डाइमेंशन, डेटा वाली लाइन में मौजूद उपयोगकर्ता गतिविधि मेट्रिक से जुड़े YouTube कॉन्टेंट के टाइप की पहचान करता है.LIVE_STREAM
,SHORTS
,STORY
, औरVIDEO_ON_DEMAND
वैल्यू का इस्तेमाल किया जा सकता है.चैनल और कॉन्टेंट के मालिक की सभी वीडियो रिपोर्ट के लिए,
creatorContentType
डाइमेंशन को वैकल्पिक डाइमेंशन के तौर पर इस्तेमाल किया जा सकता है. -
YouTube Analytics API के अनुरोधों के सैंपल की गाइड में, अब दोनों नए डाइमेंशन के उदाहरण शामिल हैं.
-
दस्तावेज़ से
7DayTotals
और30DayTotals
डाइमेंशन के रेफ़रंस हटा दिए गए हैं. इन डाइमेंशन का इस्तेमाल, अक्टूबर 2019 में नहीं किया गया था.
26 अगस्त, 2022
YouTube Analytics (टारगेट की गई क्वेरी) एपीआई और YouTube Reporting (बल्क रिपोर्ट) एपीआई, दोनों में ट्रैफ़िक सोर्स की नई जानकारी के साथ काम करते हैं:
- YouTube Analytics API (टारगेट की गई क्वेरी) एपीआई में, अगर
insightTrafficSourceType
डाइमेंशन की वैल्यूSUBSCRIBER
है, तोinsightTrafficSourceDetail
की वैल्यू कोpodcasts
पर सेट किया जा सकता है. इससे पता चलता है कि ट्रैफ़िक को 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 Reporting (बल्क रिपोर्ट) एपीआई में, फ़िलहाल
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 दिनों की अवधि में डेटा इकट्ठा करके या निकाल कर, इन डाइमेंशन के लिए कुछ डेटा फिर से जनरेट कर सकते हैं. उदाहरण के लिए:- सात दिन की अवधि में व्यू की संख्या का हिसाब, उस अवधि के हर दिन के व्यू की संख्या को एग्रीगेट करके लगाया जा सकता है.
- सात दिन की अवधि के लिए व्यूअर प्रतिशत की गणना करने के लिए, हर दिन मिलने वाले व्यू की संख्या को उस दिन के दर्शक प्रतिशत से गुणा करें. इससे, उस दिन वीडियो देखते समय लॉग इन करने वाले दर्शकों की संख्या का पता चलेगा. इसके बाद, पूरी अवधि के लिए लॉग इन किए हुए दर्शकों की संख्या को उस समय के दर्शकों की कुल संख्या से भाग देकर निकाला जा सकता है. ऐसा करने से, पूरी अवधि में व्यूअर का प्रतिशत मिलता है.
- सात दिनों की अवधि में यूनीक दर्शकों की संख्या का हिसाब नहीं लगाया जा सकता, क्योंकि अलग-अलग दिनों में एक ही दर्शक की गिनती, यूनीक दर्शक के तौर पर की जा सकती है. हालांकि, आपके पास
30DayTotals
डाइमेंशन के बजायmonth
डाइमेंशन का इस्तेमाल करने का विकल्प है. इसका इस्तेमाल करके, 30 दिनों की अवधि के दौरान यूनीक दर्शकों की संख्या के डेटा का अनुमान लगाया जा सकता है. ध्यान दें किmonth
डाइमेंशन, कैलेंडर के महीनों के बारे में जानकारी देता है. वहीं,30DayTotals
डाइमेंशन, शुरू और खत्म होने की तय तारीख के आधार पर 30 दिनों की अवधि का हिसाब लगाता है.
27 जून, 2019
इस अपडेट में, YouTube Analytics (टारगेट की गई क्वेरी) एपीआई से जुड़े ये बदलाव शामिल हैं:
-
एपीआई का पहला वर्शन अब पूरी तरह से बंद कर दिया गया है. इसलिए, इस दस्तावेज़ में नए वर्शन के रेफ़रंस हटाने के लिए, इस दस्तावेज़ को अपडेट किया गया है. इसमें, बंद किए जाने की सूचना और माइग्रेशन गाइड भी शामिल है, जो वर्शन 2 में अपडेट करने का तरीका बताती है.
1 नवंबर, 2018
इस अपडेट में, YouTube Analytics (टारगेट की गई क्वेरी) एपीआई से जुड़े ये बदलाव शामिल हैं:
-
एपीआई का वर्शन 1 अब काम नहीं करता. अगर आपने अब तक ऐसा नहीं किया है, तो कृपया अपने एपीआई क्लाइंट को जल्द से जल्द एपीआई के दूसरे वर्शन का इस्तेमाल करने के लिए अपडेट करें, ताकि सेवा में आने वाली रुकावटों को कम किया जा सके. ज़्यादा जानकारी के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड देखें.
ध्यान दें कि इस सुविधा को रोकने का शेड्यूल मूल रूप से 26 अप्रैल, 2018 को अनाउंस किया गया था.
17 सितंबर, 2018
इस अपडेट में, YouTube Analytics (टारगेट की गई क्वेरी) एपीआई से जुड़े ये बदलाव शामिल हैं:
-
डेटा मॉडल की खास जानकारी देने वाले दस्तावेज़ में मौजूद, डेटा की पहचान छिपाना सेक्शन में बताया गया है कि जब मेट्रिक तय की गई सीमा को पूरा नहीं करती हैं, तब YouTube Analytics का कुछ डेटा सीमित हो जाता है. ऐसा कई मामलों में हो सकता है. इसका मतलब यह है कि किसी रिपोर्ट में आपका पूरा डेटा (या कोई भी) डेटा नहीं हो सकता, अगर:
-
किसी खास समयावधि के दौरान, वीडियो या चैनल पर कम ट्रैफ़िक आता है,
या
-
आपने ट्रैफ़िक सोर्स या देश जैसा कोई ऐसा फ़िल्टर या डाइमेंशन चुना है जिसके लिए वैल्यू एक तय सीमा तक नहीं पहुंचती हैं.
नए सेक्शन में ऐसे डेटा के बारे में भी बताया गया है जिसे 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 (टारगेट की गई क्वेरी) एपीआई का वर्शन 2 (v2) अब सार्वजनिक तौर पर उपलब्ध है. नीचे दी गई सूची, एपीआई के नए वर्शन से जुड़े प्रॉडक्ट और दस्तावेज़ में हुए बदलावों की पहचान करती है:
-
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 API, Google के ग्लोबल एचटीटीपी बैच एंडपॉइंट (
www.googleapis.com/batch
) पर भेजे गए बैच रिक्वेस्ट के साथ काम नहीं करता. अगर v2 एपीआई में बैच रिक्वेस्ट भेजे जा रहे हैं, तो आपको एंडपॉइंटhttps://youtubeanalytics.googleapis.com/v2
का इस्तेमाल करना होगा.
इसके अलावा, v2 एपीआई में v1 की कुछ सुविधाएं काम नहीं करती हैं:
reports.query
तरीका अबalt
,quotaUser
, औरuserIp
अनुरोध पैरामीटर के साथ काम नहीं करता.- v2 API, अलग-अलग एपीआई के अनुरोधों वाले बैच के साथ काम करने वाला बैच एंडपॉइंट उपलब्ध नहीं कराता है. (हालांकि, एक बैच में एक ही एपीआई की अलग-अलग विधियों के लिए अनुरोध शामिल हो सकते हैं.) Google, अपने सभी एपीआई के लिए ग्लोबल बैच एंडपॉइंट को बंद कर रहा है. इसलिए, यह पाबंदी YouTube Analytics API के लिए नहीं है.
- v2 API, JSON-RPC प्रोटोकॉल के साथ काम नहीं करता, जो एपीआई v1 में काम करता था. ध्यान रखें कि यह सुविधा सिर्फ़ YouTube Analytics API के लिए बंद नहीं है.
- एपीआई का वर्शन
-
ध्यान दें: यह सुविधा बंद किए जाने की सूचना है.
एपीआई का पहला वर्शन (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 से जुड़े दो बदलाव शामिल हैं:
-
API सर्वर अब रिपोर्ट डाउनलोड करने वाले अनुरोधों के लिए gzip संपीड़न का समर्थन करता है. ध्यान दें कि gzip संपीड़न अन्य प्रकार के API अनुरोधों के लिए समर्थित नहीं है. gzip संपीड़न को सक्षम करने से प्रत्येक API प्रतिक्रिया के लिए आवश्यक बैंडविड्थ कम हो जाती है. साथ ही, एपीआई से मिलने वाले रिस्पॉन्स को कंप्रेस करने के लिए, आपके ऐप्लिकेशन को सीपीयू की ज़रूरत होगी. आम तौर पर, कम नेटवर्क संसाधनों का इस्तेमाल करने से फ़ायदा ज़्यादा होता है.
gzip-एन्कोडेड जवाब पाने के लिए,
Accept-Encoding
एचटीटीपी अनुरोध हेडर कोgzip
पर सेट करें, जैसा कि इस उदाहरण में दिखाया गया है:Accept-Encoding: gzip
इस फ़ंक्शन के बारे में, एपीआई की खास जानकारी और
report
संसाधन कीdownloadUrl
प्रॉपर्टी की परिभाषा में बताया गया है. -
age group
औरgender
डाइमेंशन के दस्तावेज़ में सुधार किया गया है, ताकि एपीआई उन डाइमेंशन के लिए असल वैल्यू दिखा सके. ध्यान दें कि यह दस्तावेज़ में सुधार है और इससे एपीआई के फ़ंक्शन या काम करने के तरीके में कोई बदलाव नहीं होता. खास तौर पर, ये वैल्यू बदल गई हैं:age_group
डाइमेंशन की वैल्यू में, अंग्रेज़ी के बड़े अक्षरों का इस्तेमाल किया जाता है. साथ ही, इसमेंAGE
शब्द और उम्र समूह के नंबर के बीच अंडरस्कोर शामिल होते हैं. साथ ही, इसमें हाइफ़न के बजाय अंडरस्कोर का इस्तेमाल किया जाता है. इस तरह,age13-17
औरage18-24
जैसी वैल्यू को क्रम सेAGE_13_17
औरAGE_18_24
में सही किया गया है.gender
डाइमेंशन की वैल्यू में, अंग्रेज़ी के बड़े अक्षरों का इस्तेमाल होता है. इसलिए,female
,male
, औरgender_other
वैल्यू कोFEMALE
,MALE
, औरGENDER_OTHER
में सही कर दिया गया है.
10 अगस्त, 2017
इस दस्तावेज़ में 10 अगस्त, 2016 को, YouTube Analytics API की earnings
मेट्रिक का इस्तेमाल रोकने का एलान किया गया था. इस दौरान, एपीआई ने estimatedRevenue
नाम की एक नई मेट्रिक के लिए सहायता जोड़ी. यह मेट्रिक भी वही डेटा उपलब्ध कराती है.
earnings
मेट्रिक एक मुख्य मेट्रिक थी. इसलिए, एलान की तारीख से एक साल तक इसे इस्तेमाल किया जा सकता था. साल भर की यह अवधि खत्म हो चुकी है. हालांकि, अब earnings
मेट्रिक काम नहीं करती. इस वजह से, earnings
मेट्रिक तय करने वाले एपीआई अनुरोध अब 400
एचटीटीपी रिस्पॉन्स कोड दिखाते हैं. अगर आपने earnings
मेट्रिक के बजाय, estimatedRevenue
मेट्रिक का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन को पहले से अपडेट नहीं किया है, तो इसे जल्द से जल्द अपडेट करें.
earnings
मेट्रिक के बचे हुए रेफ़रंस हटाने के लिए, एपीआई दस्तावेज़ को अपडेट किया गया है.
6 जुलाई, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Analytics API (टारगेट की गई क्वेरी)
-
एपीआई दस्तावेज़ को अपडेट कर दिया गया है, ताकि यह पता चल सके कि एपीआई से मिले रिस्पॉन्स में, अनुरोध की गई तारीख की सीमा के आखिरी दिन तक का डेटा शामिल है. इस दौरान, क्वेरी की गई सभी मेट्रिक का डेटा उपलब्ध है.
उदाहरण के लिए, अगर किसी अनुरोध में खत्म होने की तारीख 5 जुलाई, 2017 बताई गई है और अनुरोध की गई सभी मेट्रिक की वैल्यू सिर्फ़ 3 जुलाई, 2017 तक उपलब्ध हैं, तो उसी तारीख के लिए जवाब में डेटा शामिल किया जाएगा. (अगर अनुरोध की गई कुछ मेट्रिक का डेटा 4 जुलाई, 2017 तक के लिए उपलब्ध है, तब भी यह बात लागू होगी.)
-
अब
adType
डाइमेंशन के लिए,reservedBumperInstream
वैल्यू इस्तेमाल की जा सकती है. इससे छह सेकंड तक की अवधि वाले स्किप नहीं किए जा सकने वाले वीडियो विज्ञापन का इस्तेमाल किया जा सकता है. यह विज्ञापन, वीडियो देखने से पहले चलता है. विज्ञापन फ़ॉर्मैट,auctionBumperInstream
विज्ञापन से मिलता-जुलता है. हालांकि, इसमें ऐसे विज्ञापनों के बारे में बताया गया है जिन्हें नीलामी के बजाय रिज़र्व किए गए विज्ञापनों पर बेचा जाता है.
-
-
YouTube Reporting API (एक साथ कई रिपोर्ट)
-
ad_type
डाइमेंशन में अब20
वैल्यू का इस्तेमाल किया जा सकता है. यह वैल्यू, रिज़र्व के आधार पर बेचे जाने वाले बंपर विज्ञापनों के बारे में बताती है. बंपर विज्ञापन छह सेकंड तक की अवधि वाले स्किप नहीं किए जा सकने वाले वीडियो विज्ञापन होते हैं. ये वीडियो विज्ञापन से पहले चलते हैं. ध्यान दें कि इस डाइमेंशन के लिए19
वैल्यू, ऐसे बंपर विज्ञापनों के बारे में भी बताती है जिन्हें रिज़र्व के बजाय नीलामी में बेचा जाता है. -
इस YouTube Reporting API की रिपोर्ट के लिए, रिपोर्टिंग से जुड़ी नौकरियां मिटा दी गई हैं:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
इन रिपोर्ट टाइप को 15 सितंबर, 2016 को बंद कर दिया गया था. साथ ही, 15 दिसंबर, 2016 के बाद, इन रिपोर्ट टाइप के लिए रिपोर्ट जनरेट नहीं की जा रही थीं. पहले जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिन तक उपलब्ध रहती थीं. इस तरह, कुछ रिपोर्ट 15 जून, 2017 के आखिर तक ऐक्सेस की जा सकती थीं. हालांकि, रिपोर्ट अब उपलब्ध नहीं हैं, इसलिए रिपोर्ट से जुड़े जॉब की ज़रूरत नहीं है.
-
24 मई, 2017
नीचे दी गई YouTube Reporting API की रिपोर्ट के लिए, सभी रिपोर्टिंग जॉब मिटा दिए गए हैं:
content_owner_ad_performance_a1
content_owner_asset_estimated_earnings_a1
content_owner_estimated_earnings_a1
इन रिपोर्ट टाइप को 22 जून, 2016 को बंद कर दिया गया था. साथ ही, 22 सितंबर, 2016 के बाद, इन रिपोर्ट टाइप के लिए रिपोर्ट जनरेट नहीं की जा रही थीं. पहले जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिन तक उपलब्ध रहती थीं. इस तरह, कुछ रिपोर्ट 22 मार्च, 2017 के आखिर तक ऐक्सेस की जा सकती थीं. हालांकि, रिपोर्ट अब उपलब्ध नहीं हैं, इसलिए रिपोर्ट से जुड़े जॉब की ज़रूरत नहीं है.
22 मई, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Reporting API (एक साथ कई रिपोर्ट)
- वीडियो शेयर करने के लिए इस्तेमाल की गई सेवा की पहचान करने वाला
sharing_service
डाइमेंशन, अब इन वैल्यू के साथ काम करता है:85
: YouTube Music86
: YouTube गेमिंग87
: YouTube Kids88
: YouTube TV
इसके अलावा, वैल्यू
52
की पहचान करने के लिए इस्तेमाल किए गए नाम को दस्तावेज़ में अपडेट कर दिया गया है. Kakao Talk) को वैल्यू73
(Kakao Story) से बेहतर तरीके से अलग करने के लिए, ऐसा किया गया है. यह बदलाव, एपीआई के काम करने के तरीके या इन सेवाओं के साथ शेयर किए गए वीडियो की कैटगरी में कोई बदलाव नहीं करता.
- वीडियो शेयर करने के लिए इस्तेमाल की गई सेवा की पहचान करने वाला
-
YouTube Analytics API (टारगेट की गई क्वेरी)
sharingService
डाइमेंशन में अब ये वैल्यू इस्तेमाल की जा सकती हैं:YOUTUBE_GAMING
YOUTUBE_KIDS
YOUTUBE_MUSIC
YOUTUBE_TV
28 मार्च, 2017
YouTube Analytics की मदद से YouTube Analytics में मौजूद रेवेन्यू का डेटा ऐक्सेस करने वाले चैनल के मालिक, अब YouTube Analytics API से भी रेवेन्यू के इस डेटा को ऐक्सेस कर सकते हैं:
-
यह एपीआई, रेवेन्यू से जुड़ी इन मेट्रिक के साथ काम करता है:
adImpressions
cpm
estimatedAdRevenue
estimatedRedPartnerRevenue
estimatedRevenue
grossRevenue
monetizedPlaybacks
playbackBasedCpm
ये मेट्रिक, इन रिपोर्ट के लिए इस्तेमाल की जा सकती हैं:
-
चैनल के मालिक अब विज्ञापन की परफ़ॉर्मेंस रिपोर्ट भी हासिल कर सकते हैं. यह रिपोर्ट,
adType
डाइमेंशन के साथ-साथ वैकल्पिकday
डाइमेंशन का भी इस्तेमाल करती है. -
YouTube Analytics API के अनुरोधों के सैंपल की गाइड में, अब चैनल की आय की रिपोर्ट के लिए एक सेक्शन शामिल है.
17 मार्च, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Analytics API,
redViews
औरestimatedRedMinutesWatched
मेट्रिक के साथ काम करता है. ये दोनों मेट्रिक YouTube Red के दर्शकों की संख्या से जुड़ी हैं. असल में, एपीआई ने कुछ समय के लिए इन मेट्रिक का इस्तेमाल किया है और YouTube Reporting API पहले से ही दोनों मेट्रिक के साथ काम करता है. इसकी जानकारी 15 सितंबर, 2016 को दी गई थी.redViews
मेट्रिक से पता चलता है कि YouTube Red के सदस्यों ने किसी वीडियो को कितनी बार देखा है.estimatedRedMinutesWatched
मेट्रिक से पता चलता है कि YouTube Premium के सदस्यों ने कितने मिनट तक वीडियो देखा.
चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट से जुड़े दस्तावेज़ अपडेट किए गए हैं. ऐसा इसलिए किया गया है, ताकि यह दिखाया जा सके कि कौनसी रिपोर्ट दो नई मेट्रिक के साथ काम करती है. इनका इस्तेमाल उन सभी रिपोर्ट में किया जा सकता है जिनमें
views
औरestimatedMinutesWatched
मेट्रिक पहले से काम करती हों.
3 मार्च, 2017
इस अपडेट में ये बदलाव शामिल हैं:
-
YouTube Reporting API (एक साथ कई रिपोर्ट)
-
date
डाइमेंशन की परिभाषा में सुधार किया गया है कि डाइमेंशन की वैल्यू, किसी खास दिन, महीने, और साल के हिसाब से रात 12:00 बजे पैसिफ़िक समय से शुरू होकर 11:59 बजे पैसिफ़िक समय पर खत्म होती है. साल के समय के आधार पर, पैसिफ़िक समय यूटीसी-7 या यूटीसी-8 होता है.आम तौर पर, तारीखें 24 घंटे की होती हैं, लेकिन जब घड़ियों में बदलाव किया जाता है, तो ये 23 घंटे की अवधि दिखाती हैं. वहीं, जिन घड़ियों को पीछे की तरफ़ अडजस्ट किया जाता है वे 25 घंटे की अवधि हैं. (पहले, दस्तावेज़ में बताया गया था कि हर तारीख 24 घंटे की खास अवधि को दिखाती है और पैसिफ़िक समय हमेशा यूटीसी-8 होता है.)
ध्यान दें कि यह सुधार, एपीआई के असल काम करने के तरीके में कोई बदलाव नहीं करता.
operating_system
डाइमेंशन, जो उस डिवाइस के सॉफ़्टवेयर सिस्टम की पहचान करता है जिस पर व्यू मिले:22
: टिज़ेन23
: Firefox24
: 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
इस अपडेट में ये बदलाव शामिल हैं:
-
एंड स्क्रीन की रिपोर्ट
- चैनल के वीडियो की एंड स्क्रीन रिपोर्ट में चैनल के सभी वीडियो के आंकड़े होते हैं.
- कॉन्टेंट के मालिक के वीडियो की एंड स्क्रीन रिपोर्ट में किसी कॉन्टेंट मालिक के चैनल के वीडियो के आंकड़े शामिल होते हैं.
- कॉन्टेंट के मालिक की एसेट के लिए एंड स्क्रीन रिपोर्ट में, उन वीडियो से जुड़ी एसेट के आंकड़े होते हैं जिनके बाद एंड स्क्रीन दिखती हैं.
-
एंड स्क्रीन के डाइमेंशन
end_screen_element_type
: आंकड़ों से जुड़े एंड स्क्रीन एलिमेंट का टाइप.end_screen_element_id
: वह आईडी जिसका इस्तेमाल YouTube, एंड स्क्रीन एलिमेंट की खास तरह से पहचान करने के लिए करता है.
एंड स्क्रीन की मेट्रिक
ध्यान दें: एंड स्क्रीन की मेट्रिक के लिए 1 मई, 2016 से डेटा उपलब्ध है.
end_screen_element_impressions
: एंड स्क्रीन पर दिखने वाले एलिमेंट पर मिले इंप्रेशन की कुल संख्या. एंड स्क्रीन पर दिखने वाले हर एलिमेंट के लिए, एक इंप्रेशन लॉग किया जाता है.end_screen_element_clicks
: एंड स्क्रीन पर दिखने वाले एलिमेंट पर कितनी बार क्लिक किया गया.end_screen_element_click_rate
: एंड स्क्रीन पर मौजूद एलिमेंट के लिए क्लिक मिलने की दर (सीटीआर).
-
ये रिपोर्ट अब काम नहीं करती हैं. इसलिए, इन्हें दस्तावेज़ से हटा दिया गया है. हर रिपोर्ट का नया वर्शन उपलब्ध है. (इन रिपोर्ट के लिए रोक लगाने की घोषणा 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
रिपोर्ट से बदला गया.
-
नीचे दी गई सूची में मौजूद मेट्रिक पूरी तरह से अब काम नहीं करतीं. जैसा कि 10 अगस्त, 2016 को बताया गया था, इसी डेटा से जुड़ी नई मेट्रिक पहले से ही काम कर रही हैं. नीचे दी गई टेबल में, मेट्रिक का नया नाम और अमान्य मेट्रिक का नाम दिखाया गया है:
बहिष्कृत मेट्रिक नई मेट्रिक adEarnings
estimatedAdRevenue
impressionBasedCpm
cpm
impressions
adImpressions
redPartnerRevenue
estimatedRedPartnerRevenue
- हर वीडियो पर हर महीने, दुनिया भर में दिखने वाले विज्ञापनों से होने वाली आय
- हर देश के हिसाब से, हर वीडियो पर हर दिन विज्ञापन से होने वाली आय
- हर एसेट पर हर महीने, दुनिया भर में दिखने वाले विज्ञापन से होने वाली आय
- हर देश में हर ऐसेट के लिए विज्ञापन से होने वाली रोज़ाना की आय
- दावे (इस रिपोर्ट में रेवेन्यू का डेटा शामिल नहीं होता)
-
यह एपीआई, YouTube Red के दर्शकों की संख्या से जुड़ी दो नई मेट्रिक के साथ काम करता है:
red_views
: वह संख्या जो बताती है कि YouTube Red के सदस्यों ने किसी वीडियो को कितनी बार देखा है.red_watch_time_minutes
: कितने मिनट तक YouTube Red के सदस्यों ने वीडियो देखा.
-
यह एपीआई, 20 रिपोर्ट के नए वर्शन के साथ काम करता है. सभी नए वर्शन, नई
red_views
औरred_watch_time_minutes
मेट्रिक के साथ काम करते हैं.हर रिपोर्ट के लिए, नए रिपोर्ट टाइप आईडी में मौजूद संख्या, पुराने रिपोर्ट टाइप आईडी से एक संख्या ज़्यादा है. (इन रिपोर्ट के पुराने वर्शन अब हटा दिए गए हैं, जैसा कि इस बदलाव के इतिहास में बाद में बताया गया है.) उदाहरण के लिए,
channel_basic_a1
रिपोर्ट अब काम नहीं करती और उसेchannel_basic_a2
रिपोर्ट से बदल दिया गया है.नीचे दी गई सूचियां, रिपोर्ट के नए टाइप आईडी की पहचान करती हैं:
चैनल की वीडियो रिपोर्ट
कॉन्टेंट के मालिक के वीडियो की रिपोर्ट
कॉन्टेंट के मालिक की एसेट रिपोर्ट
-
ध्यान दें: यह सुविधा बंद किए जाने की सूचना है.
ध्यान दें, अगर आपके पास ऊपर दी गई रिपोर्ट के किसी भी पुराने वर्शन को बनाने के लिए पहले से जॉब मौजूद हैं, तो आपको बदले गए नाम वाली रिपोर्ट के लिए नए जॉब बनाने होंगे. रिपोर्ट के नए वर्शन की रिलीज़ के साथ-साथ, रिपोर्ट के इन वर्शन को हटा दिया गया है:
channel_basic_a1
channel_province_a1
channel_playback_location_a1
channel_traffic_source_a1
channel_device_os_a1
channel_subtitles_a1
channel_combined_a1
content_owner_basic_a2
content_owner_province_a1
content_owner_playback_location_a1
content_owner_traffic_source_a1
content_owner_device_os_a1
content_owner_subtitles_a1
content_owner_combined_a1
content_owner_asset_basic_a1
content_owner_asset_province_a1
content_owner_asset_playback_location_a1
content_owner_asset_traffic_source_a1
content_owner_asset_device_os_a1
content_owner_asset_combined_a1
अगर आपके पास उनमें से किसी भी रिपोर्ट के लिए नौकरियां हैं, तो आपको यह उम्मीद नहीं करनी चाहिए कि YouTube 15 दिसंबर, 2016 के बाद उन नौकरियों के लिए नई रिपोर्ट जनरेट करेगा. जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिन तक उपलब्ध रहेंगी.
-
content_owner_basic_a1
रिपोर्ट के इस्तेमाल पर पूरी तरह से रोक लगा दी गई है और उसे दस्तावेज़ से हटा दिया गया है. YouTube अब इस तरह की नई रिपोर्ट जनरेट नहीं करेगा. हालांकि, पहले से जनरेट की गई रिपोर्ट, जनरेट होने के बाद 180 दिन तक उपलब्ध रहेंगी.content_owner_basic_a1
रिपोर्ट की जगह,content_owner_basic_a2
रिपोर्ट का इस्तेमाल किया जाएगा. इसके बारे में 19 मई, 2016 की बदलाव के इतिहास की एंट्री में बताया गया है. -
YouTube API सेवाओं की हाल ही में पब्लिश की गई सेवा की शर्तें ("अपडेट की गई शर्तें"), जिनके बारे में YouTube इंजीनियरिंग और डेवलपर ब्लॉग पर विस्तार से बताया गया है. इनसे सेवा की मौजूदा शर्तों में कई बेहतर अपडेट मिलते हैं. 10 फ़रवरी, 2017 से लागू होने वाली अपडेट की गई शर्तों के अलावा, इस अपडेट में कई सहायक दस्तावेज़ शामिल हैं. इनसे उन नीतियों की जानकारी मिलती है जिनका पालन डेवलपर को करना ज़रूरी है.
नए दस्तावेज़ों के पूरे सेट के बारे में, अपडेट की गई शर्तों के बदलाव का इतिहास सेक्शन में बताया गया है. इसके अलावा, अपडेट की गई शर्तों या उन दस्तावेज़ों में आने वाले समय में होने वाले बदलावों की जानकारी, उन बदलावों के इतिहास में भी दी जाएगी. उस दस्तावेज़ में मौजूद किसी लिंक से, बदलावों के इतिहास में आरएसएस फ़ीड की लिस्टिंग में हुए बदलावों की सदस्यता ली जा सकती है.
-
YouTube Analytics API (टारगेट की गई क्वेरी)
-
ध्यान दें: यह सुविधा बंद किए जाने की सूचना है.
इस टेबल में मौजूद मेट्रिक अब काम नहीं करतीं. साथ ही, अब उसी डेटा से जुड़ी नई मेट्रिक बनाई जा रही हैं. इसका मतलब है कि पुराने मेट्रिक के नाम बदले जा रहे हैं. हालांकि, जब तक टेबल में बंद करने की तारीखें नहीं बताई जातीं, तब तक YouTube Analytics API दोनों मेट्रिक के नामों का इस्तेमाल करेगा.
मेट्रिक का पुराना नाम मेट्रिक का नया नाम सहायता की तारीख earnings
estimatedRevenue
10 अगस्त, 2017 adEarnings
estimatedAdRevenue
4 नवंबर, 2016 redPartnerRevenue
estimatedRedPartnerRevenue
4 नवंबर, 2016 impressionBasedCpm
cpm
4 नवंबर, 2016 impressions
adImpressions
4 नवंबर, 2016 ध्यान दें कि
earnings
मेट्रिक एक मुख्य मेट्रिक है. इसलिए, यह एलान इस तारीख से एक साल तक काम करता रहेगा. अन्य मेट्रिक, जो मुख्य मेट्रिक नहीं थीं, उन्हें 4 नवंबर, 2016 तक तीन महीने तक इस्तेमाल किया जाएगा.उदाहरण के लिए, 4 नवंबर, 2016 तक, एपीआई अनुरोध में
impressionBasedCpm
मेट्रिक,cpm
मेट्रिक या दोनों की जानकारी दी जा सकती है. हालांकि, इस तारीख के बाद सिर्फ़cpm
मेट्रिक के साथ काम किया जाएगा. insightTrafficSourceType
डाइमेंशन में, दो नई डाइमेंशन वैल्यू इस्तेमाल की जा सकती हैं:CAMPAIGN_CARD
: यह ट्रैफ़िक सोर्स सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए काम करता है. इससे पता चलता है कि उपयोगकर्ता के अपलोड किए गए, दावा किए गए वीडियो पर व्यू, कॉन्टेंट के मालिक ने देखे गए कॉन्टेंट का प्रमोशन करने के लिए इस्तेमाल किए हैं.END_SCREEN
: यह डेटा, किसी दूसरे वीडियो की एंड स्क्रीन से मिले व्यू से जुड़ा है.
दोनों नए ट्रैफ़िक सोर्स के लिए,
traffic source detail
रिपोर्ट भी फिर से पाई जा सकती है. दोनों मामलों में,insightTrafficSourceDetail
डाइमेंशन उस वीडियो की पहचान करता है जिससे दर्शक को रेफ़र किया गया है.-
अब
adType
डाइमेंशन के लिए,auctionBumperInstream
वैल्यू इस्तेमाल की जा सकती है. इससे छह सेकंड तक की अवधि वाले स्किप नहीं किए जा सकने वाले वीडियो विज्ञापन का इस्तेमाल किया जा सकता है. यह विज्ञापन, वीडियो देखने से पहले चलता है.
-
-
YouTube Reporting API (एक साथ कई रिपोर्ट)
traffic_source_type
डाइमेंशन में अब ये वैल्यू इस्तेमाल की जा सकती हैं:19
: यह ट्रैफ़िक सोर्स सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए काम करता है. इससे पता चलता है कि उपयोगकर्ता के अपलोड किए गए, दावा किए गए वीडियो पर व्यू, कॉन्टेंट के मालिक ने देखे गए कॉन्टेंट का प्रमोशन करने के लिए इस्तेमाल किए हैं.20
: यह डेटा, किसी दूसरे वीडियो की एंड स्क्रीन से मिले व्यू से जुड़ा है.
दोनों नए ट्रैफ़िक सोर्स के लिए,
traffic_source_detail
डाइमेंशन उस वीडियो की पहचान करता है जिससे दर्शक को रेफ़र किया गया है.-
estimated_partner_revenue
को मुख्य मेट्रिक के तौर पर सूची में शामिल करने और उस सूची सेearnings
को हटाने के लिए, एपीआई की मुख्य मेट्रिक की सूची में सुधार किया गया है. (earnings
मेट्रिक, YouTube Reporting API में कभी काम नहीं करती.) -
अब
ad_type
डाइमेंशन में,19
की वैल्यू इस्तेमाल की जा सकती है. बंपर विज्ञापन, छह सेकंड तक की अवधि के स्किप नहीं किए जा सकने वाले वीडियो विज्ञापन होते हैं. ये वीडियो विज्ञापन, वीडियो देखने से पहले चलते हैं.
-
YouTube Analytics API (टारगेट की गई क्वेरी)
- कार्ड मेट्रिक को शामिल करने के लिए, यहां दी गई चैनल रिपोर्ट के लिए इस्तेमाल की जा सकने वाली मेट्रिक की सूचियां अपडेट की गई हैं. इन रिपोर्ट में कार्ड मेट्रिक के लिए सहायता को असल में 28 जून, 2016 को जोड़ा गया था और उस तारीख के लिए बदलाव के इतिहास की एंट्री बदलाव के बारे में ज़्यादा जानकारी देती है. ये रिपोर्ट:
- अमेरिका के राज्यों में उपयोगकर्ता की बुनियादी गतिविधि
- खास समयावधि के दौरान, अमेरिका के राज्यों में उपयोगकर्ता की गतिविधि
- प्रांत के हिसाब से उपयोगकर्ता की गतिविधि
- सदस्यता की स्थिति के हिसाब से उपयोगकर्ता की गतिविधि
- प्रांतों के लिए सदस्यता की स्थिति के मुताबिक उपयोगकर्ता की गतिविधि
- राज्य के हिसाब से सबसे ज़्यादा देखे गए वीडियो
- जिन दर्शकों ने आपके चैनल की सदस्यता ली है या जिन्होंने सदस्यता नहीं ली है उनके लिए सबसे ज़्यादा देखे गए वीडियो
-
चैनल के लिए दर्शक बनाए रखने की रिपोर्ट और कॉन्टेंट के मालिक के लिए दर्शक बनाए रखने की रिपोर्ट, दोनों के लिए फ़िल्टर की सूचियों में सुधार किया गया है. इससे पता चलता है कि
video
फ़िल्टर की ज़रूरत है औरgroup
फ़िल्टर काम नहीं करता.पहले, दोनों रिपोर्ट के दस्तावेज़ों में गलत तरीके से बताया गया था कि उन दोनों फ़िल्टर में से किसी एक का इस्तेमाल करके या दोनों में से किसी भी फ़िल्टर का इस्तेमाल करके, रिपोर्ट को फिर से पाया जा सकता है.
- कार्ड मेट्रिक को शामिल करने के लिए, यहां दी गई चैनल रिपोर्ट के लिए इस्तेमाल की जा सकने वाली मेट्रिक की सूचियां अपडेट की गई हैं. इन रिपोर्ट में कार्ड मेट्रिक के लिए सहायता को असल में 28 जून, 2016 को जोड़ा गया था और उस तारीख के लिए बदलाव के इतिहास की एंट्री बदलाव के बारे में ज़्यादा जानकारी देती है. ये रिपोर्ट:
-
YouTube Reporting API (एक साथ कई रिपोर्ट)
- एपीआई की खास जानकारी में, रिपोर्ट के डाउनलोड यूआरएल को वापस पाने का तरीका बताने वाले सेक्शन में सुधार किया गया है. इसमें बताया गया है कि YouTube उन दिनों के लिए डाउनलोड की जा सकने वाली रिपोर्ट जनरेट करता है जिनमें कोई डेटा उपलब्ध नहीं था. उन रिपोर्ट में एक हेडर लाइन होती है, लेकिन उसमें अतिरिक्त डेटा नहीं होता. इस जानकारी को इसी दस्तावेज़ के रिपोर्ट की विशेषताएं सेक्शन में, 12 अप्रैल, 2016 को पहले ही अपडेट कर दिया गया था.
content_owner_asset_cards_a1
रिपोर्ट में डाइमेंशन की सूची में सुधार किया गया है, ताकि यह पता चल सके कि रिपोर्टcard_id
डाइमेंशन का इस्तेमाल करती है. पहले, दस्तावेज़ में डाइमेंशन का नाम गलती सेcard_title
के तौर पर दिखाया गया था.
- बुनियादी आंकड़े(चैनल, कॉन्टेंट के मालिक)
- समय के हिसाब से(चैनल, कॉन्टेंट के मालिक)
- उपयोगकर्ता के देश या इलाके (चैनल, कॉन्टेंट के मालिक)
- सदस्यता की स्थिति के हिसाब से उपयोगकर्ता की गतिविधि (चैनल, कॉन्टेंट के मालिक)
- सबसे ज़्यादा देखे गए वीडियो (चैनल, कॉन्टेंट के मालिक)
-
एपीआई की खास जानकारी के रिपोर्ट की विशेषताएं सेक्शन अपडेट किया गया है. इससे यह साफ़ तौर पर पता चलेगा कि रिपोर्ट जनरेट होने के बाद 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
प्रॉपर्टी को सूची में शामिल नहीं किया जा सके. फ़िलहाल, ये डाइमेंशन, एपीआई से उपलब्ध किसी भी रिपोर्ट के साथ काम नहीं करते. -
यह एपीआई, कॉन्टेंट के मालिकों के लिए उपयोगकर्ता गतिविधि की रिपोर्ट के नए वर्शन पर काम करता है. नई रिपोर्ट के लिए रिपोर्ट टाइप आईडी
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
) दिखाता है. इसके अलावा, तरीके के दस्तावेज़ में अब ऐसी कई और वजहों की सूची दी गई है जिनकी वजह से एपीआई अनुरोध काम नहीं करता. -
रिपोर्टिंग जॉब को पहली बार शेड्यूल करने से पहले का 180 दिन का डेटा, YouTube अब जनरेट करता है. इससे पहले, Reporting API ने कोई पुराना डेटा डिलीवर नहीं किया था. इस बदलाव का असर सभी जॉब पर पड़ेगा. इनमें, इस एलान से पहले बनाई गई जॉब भी शामिल हैं.
पुरानी रिपोर्ट उपलब्ध होते ही पोस्ट कर दी जाती हैं. हालांकि, किसी नौकरी से जुड़ा सारा पुराना डेटा पोस्ट होने में करीब एक महीना लगता है. इसलिए, रिपोर्टिंग का काम शेड्यूल करने के एक महीने बाद, आपके पास करीब सात महीनों के डेटा का ऐक्सेस होगा. (इस एलान से पहले बनाई गई नौकरियों का पुराना डेटा, एलान किए जाने के एक महीने के अंदर पोस्ट कर दिया जाना चाहिए.)
ध्यान दें कि पुराना डेटा सिर्फ़ 1 जुलाई, 2015 से उपलब्ध है. इस वजह से, 28 दिसंबर, 2015 से पहले बनाई गई नौकरियों का पुराना डेटा 180 दिनों से कम रहेगा.
इन बदलावों के बारे में रिपोर्टिंग API की खास जानकारी के नए पुराने डेटा सेक्शन में बताया गया है.
-
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
है.
-
- 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 सिस्टम गतिविधि डायलॉग
playback_location_type
डाइमेंशन में, दो नई डाइमेंशन वैल्यू इस्तेमाल की जा सकती हैं:7
: यह डेटा, YouTube के होम पेज या होम स्क्रीन, सदस्यता फ़ीड या YouTube की किसी दूसरी ब्राउज़िंग सुविधा पर मिले व्यू से जुड़ा है.8
: यह डेटा, YouTube के खोज नतीजों के पेज पर आए व्यू से जुड़ा है.
traffic_source_type
डाइमेंशन में, अब डाइमेंशन वैल्यू के तौर पर18
का इस्तेमाल किया जा सकता है. इस वैल्यू से पता चलता है कि वीडियो पर मिले व्यू की शुरुआत किसी ऐसे पेज से हुई जो प्लेलिस्ट के सभी वीडियो की सूची बनाता है. यह सोर्स, सोर्स टाइप14
से अलग है. इससे पता चलता है कि वीडियो को उस समय देखा गया था, जब वीडियो को प्लेलिस्ट के तौर पर चलाया गया था.insightPlaybackLocationType
डाइमेंशन में, दो नई डाइमेंशन वैल्यू इस्तेमाल की जा सकती हैं:BROWSE
: यह डेटा, YouTube के होम पेज या होम स्क्रीन, सदस्यता फ़ीड या YouTube की किसी दूसरी ब्राउज़िंग सुविधा पर मिले व्यू से जुड़ा है.SEARCH
: यह डेटा, YouTube के खोज नतीजों के पेज पर आए व्यू से जुड़ा है.
insightTrafficSourceType
डाइमेंशन में, अब डाइमेंशन वैल्यू के तौर परYT_PLAYLIST_PAGE
का इस्तेमाल किया जा सकता है. इस वैल्यू से पता चलता है कि वीडियो पर मिले व्यू की शुरुआत किसी ऐसे पेज से हुई जो प्लेलिस्ट के सभी वीडियो की सूची बनाता है. यह सोर्स,PLAYLIST
सोर्स टाइप से अलग है. सोर्स टाइप से पता चलता है कि वीडियो को तब देखा गया, जब वीडियो को प्लेलिस्ट के तौर पर चलाया गया था.- YouTube Reporting API में,
operating_system
डाइमेंशन,21
वैल्यू का इस्तेमाल करके Chromecast से होने वाले व्यू की पहचान करता है. - Chromecast से होने वाले व्यू की पहचान करने के लिए, YouTube Analytics API में
operatingSystem
डाइमेंशन,CHROMECAST
वैल्यू का इस्तेमाल करता है. -
YouTube Analytics API में, अब वीडियो चलाने की जानकारी वाले तीन नए डाइमेंशन इस्तेमाल किए जा सकते हैं. इनका इस्तेमाल, चैनल और कॉन्टेंट के मालिक की अलग-अलग रिपोर्ट में किया जा सकता है:
liveOrOnDemand
: इस डाइमेंशन से पता चलता है कि रिपोर्ट के डेटा में, लाइव ब्रॉडकास्ट के दौरान हुई उपयोगकर्ता गतिविधि की जानकारी मौजूद है या नहीं.subscribedStatus
: इस डाइमेंशन से पता चलता है कि डेटा में मौजूद उपयोगकर्ता गतिविधि की मेट्रिक, उन दर्शकों से जुड़ी है या नहीं जिन्होंने वीडियो या प्लेलिस्ट के चैनल की सदस्यता ली थी.youtubeProduct
: यह डाइमेंशन उस YouTube प्रॉपर्टी की पहचान करता है जिस पर उपयोगकर्ता गतिविधि हुई थी. इसमें YouTube की मुख्य वेबसाइट (या YouTube ऐप्लिकेशन), YouTube Gaming, और YouTube Kids जैसी जानकारी शामिल हो सकती है.
वीडियो चलाने की ज़्यादा जानकारी वाली नई रिपोर्ट की पहचान करने के लिए, दस्तावेज़ को अपडेट किया गया है. ये रिपोर्ट चैनल और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं. इसके अलावा, कई अन्य रिपोर्ट को यह नोट करने के लिए अपडेट किया गया है कि इनमें से एक या ज़्यादा डाइमेंशन को उन रिपोर्ट में वैकल्पिक तौर पर डाइमेंशन और/या फ़िल्टर के तौर पर इस्तेमाल किया जा सकता है.
-
रिपोर्ट के बारे में जानकारी देने वाली टेबल के फ़ॉर्मैट में बदलाव किया गया है. इससे आपके लिए, डाइमेंशन, मेट्रिक, और फ़िल्टर के ऐसे मान्य कॉम्बिनेशन की पहचान करना आसान हो गया है जिनका इस्तेमाल, हर रिपोर्ट को फिर से पाने के लिए किया जा सकता है. नीचे दी गई टेबल में, चैनलों के लिए "डिवाइस टाइप" रिपोर्ट का नया फ़ॉर्मैट दिखाया गया है:
विषय सूची डाइमेंशन: ज़रूरी है deviceType शून्य या उससे ज़्यादा का इस्तेमाल करें day, liveOrOnDemand, subscribedStatus, youtubeProduct मेट्रिक 1 या उससे ज़्यादा का इस्तेमाल करें व्यू, estimatedMinutesWatched छनक: 0 या 1 का इस्तेमाल करें country, प्रांत, महाद्वीप, subContinent 0 या 1 का इस्तेमाल करें वीडियो, ग्रुप शून्य या उससे ज़्यादा का इस्तेमाल करें operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct चैनल और कॉन्टेंट के मालिक की रिपोर्ट के दस्तावेज़ में, ज़रूरी और वैकल्पिक फ़ील्ड के बारे में बताने वाली शब्दावली की जानकारी दी गई है.
-
YouTube Analytics API अब उन इकाइयों को अपने-आप हटा देता है जिन्हें एपीआई उपयोगकर्ता, एक से ज़्यादा वैल्यू (
video
,playlist
, औरchannel
) के साथ काम करने वाले फ़िल्टर से डेटा हासिल नहीं कर सकता. पहले, अगर एपीआई उपयोगकर्ता बताए गए आइटम में से कम से कम एक के लिए डेटा ऐक्सेस नहीं कर पाता था, तो एपीआई सर्वर में गड़बड़ी दिखती थी.उदाहरण के लिए, मान लें कि कोई उपयोगकर्ता एक ऐसा एपीआई अनुरोध सबमिट करता है जिसमें
video
फ़िल्टर में 20 वीडियो आईडी दिए गए हैं. उपयोगकर्ता के पास 18 वीडियो हैं. हालांकि, एक वीडियो आईडी, दूसरे चैनल के मालिकाना हक वाले वीडियो की पहचान करता है. वहीं, दूसरा आईडी उस वीडियो की पहचान करता है जिसे मिटा दिया गया है. इस वजह से वह अब मौजूद नहीं है. इस मामले में, गड़बड़ी का मैसेज दिखाने के बजाय, एपीआई सर्वर अब उन दो वीडियो को हटा देता है जिन्हें उपयोगकर्ता ऐक्सेस नहीं कर सकता. साथ ही, एपीआई के रिस्पॉन्स में उन 18 वीडियो का डेटा शामिल होता है जो एपीआई उपयोगकर्ता के पास हैं. -
अगर आपने बिना YouTube Analytics
group
के डेटा का अनुरोध किया है, तो एपीआई गड़बड़ी के बजाय खाली डेटा सेट दिखाता है. -
अगर आपके पास किसी ग्रुप में कोई इकाई जोड़नी है, लेकिन आपके पास उस इकाई का ऐक्सेस नहीं है, तो YouTube Analytics API के
groupItems.insert
तरीके से, अब बिना अनुमति वाले (403
एचटीटीपी रिस्पॉन्स कोड) वाली गड़बड़ी मिलती है. पहले, एपीआई आपको इकाई को ग्रुप में जोड़ने की अनुमति देता था, लेकिन बाद में उस ग्रुप के लिए रिपोर्ट का डेटा पाने की कोशिश करने पर बिना अनुमति के कोई गड़बड़ी मिली. -
YouTube Analytics API के
groups.list
तरीके से अब पेज पर नंबर डाला जा सकता है. अगर एपीआई रिस्पॉन्स में सभी उपलब्ध ग्रुप शामिल नहीं हैं, तो रिस्पॉन्स केnextPageToken
पैरामीटर से एक टोकन के बारे में पता चलता है. इसका इस्तेमाल, नतीजों का अगला पेज पाने के लिए किया जा सकता है. ज़्यादा नतीजे पाने के लिए, तरीके केpageToken
पैरामीटर को उस वैल्यू पर सेट करें. -
YouTube Analytics API में अब
redPartnerRevenue
मेट्रिक का इस्तेमाल किया जा सकता है. यह मेट्रिक, चुने गए रिपोर्ट डाइमेंशन के लिए, YouTube Red की सदस्यताओं से हुई कुल अनुमानित आय की जानकारी देती है. मेट्रिक की वैल्यू, संगीत और बिना संगीत वाले कॉन्टेंट, दोनों से होने वाली कमाई के बारे में बताती है. यह महीने के आखिर में अडजस्ट होती है.YouTube Analytics API की, कॉन्टेंट के मालिक की रिपोर्ट की सूची अपडेट कर दी गई है, ताकि
redPartnerRevenue
मेट्रिक का इस्तेमाल करने वाली वीडियो रिपोर्ट की पहचान की जा सके:- सामान्य आंकड़े
- समय के हिसाब से
- उपयोगकर्ता का देश या इलाका
- सबसे ज़्यादा देखे गए वीडियो – इस रिपोर्ट के लिए,
redPartnerRevenue
को क्रम से लगाने वाली मेट्रिक के तौर पर भी इस्तेमाल किया जा सकता है. इसका मतलब है कि आपको YouTube Red से हुई कमाई के हिसाब से क्रम में लगाए गए वीडियो की सूची मिल सकती है.
-
YouTube Analytics API के लिए सबसे ज़्यादा देखे गए वीडियो वाली रिपोर्ट में अब यह देखा जा सकता है कि इस रिपोर्ट में, कमाई की इन मेट्रिक का भी इस्तेमाल किया जाता है:
earnings
,adEarnings
,grossRevenue
,monetizedPlaybacks
,playbackBasedCpm
,impressions
, औरimpressionBasedCpm
. -
YouTube Reporting API के
date
डाइमेंशन के दस्तावेज़ में बदलाव किया गया है, ताकि यह बताया जा सके कि पैसिफ़िक समय के हिसाब से रात 12:00 बजे (यूटीसी-8) से शुरू होने वाली 24 घंटे की अवधि से यह जानकारी मिलती है. इससे पहले, दस्तावेज़ में बताया गया था कि यह तारीख, रात 12:00 बजे (जीएमटी) से शुरू हुई थी.इसके अलावा, 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
प्रॉपर्टी की परिभाषाओं में सुधार किया गया है. ऐसा यह बताने के लिए किया गया है कि प्रॉपर्टी की वैल्यू, माइक्रोसेकंड के लिए सटीक हैं, न कि नैनोसेकंड. इसके अलावा, अब सभी परिभाषाएं सटीक रूप से दिखाती हैं कि प्रॉपर्टी की वैल्यू एक टाइमस्टैंप है. -
YouTube Analytics API के
sharingService
डाइमेंशन के दस्तावेज़ को अपडेट किया गया है, ताकि डाइमेंशन की संभावित वैल्यू की सूची को शामिल किया जा सके. सूची में कई नई सेवाएं शामिल हैं.YouTube Reporting API की
sharing_service
डाइमेंशन की परिभाषा को भी अपडेट किया गया है, ताकि इसमें इस्तेमाल की जा सकने वाली नई वैल्यू को सूची में शामिल किया जा सके.59
से बड़े एनम वैल्यू, सूची में नई वैल्यू हैं. -
नए 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 के लिए, रेफ़रंस दस्तावेज़ और अन्य कॉन्टेंट मौजूद होता है.
- सैंपल टैब में, दोनों में से किसी एक एपीआई के लिए उपलब्ध कोड सैंपल की सूची होती है.
- टूल टैब में ऐसे अतिरिक्त संसाधनों की सूची होती है जिनसे डेवलपर को दोनों में से किसी एक एपीआई को लागू करने में मदद मिलती है.
-
एपीआई के दस्तावेज़ को फिर से तैयार किया गया है, ताकि एपीआई को आसानी से समझा जा सके. इसलिए, ये बदलाव नई सुविधाओं के बारे में नहीं बताते:
-
दस्तावेज़ में अब एक पेज शामिल है, जिसमें सभी उपलब्ध चैनल की रिपोर्ट मौजूद हैं. साथ ही, दूसरे पेज में कॉन्टेंट के मालिक से जुड़ी सभी उपलब्ध रिपोर्ट मौजूद हैं. पहले, इस दस्तावेज़ में चैनल की वीडियो रिपोर्ट, चैनल की प्लेलिस्ट की रिपोर्ट वगैरह के लिए अलग-अलग पेज होते थे.
-
नए डेटा मॉडल की खास जानकारी में, एपीआई के काम करने के तरीके के बारे में ज़्यादा जानकारी दी गई है. खास तौर पर, इस दस्तावेज़ में बेहतर तरीके से बताया गया है कि YouTube, रिपोर्ट की वैल्यू का हिसाब लगाने के लिए, मेट्रिक, डाइमेंशन, और फ़िल्टर का इस्तेमाल कैसे करता है.
-
रिपोर्ट को फिर से पाने के लिए इस्तेमाल किए जाने वाले एपीआई के
reports.query
तरीके को अब अलग से दस्तावेज़ में रखा जाता है. उस पेज पर मौजूद जानकारी पहले कुछ अन्य पेजों पर मौजूद थी. नए पेज को इस तरह से डिज़ाइन किया गया है कि आप उस जानकारी को ज़्यादा आसानी से पहचान सकें जो आपको रिपोर्ट पाने के लिए भेजनी होती है.
-
-
adEarnings
की नई मेट्रिक में, Google की ओर से बेचे गए विज्ञापन के सभी स्रोतों से होने वाली कुल अनुमानित आय (कुल आय) शामिल होती है. यह एक मुख्य मेट्रिक नहीं है. यह एपीआई, ऐसी किसी भी रिपोर्ट के लिएadEarnings
मेट्रिक के साथ काम करता है जो पहले से हीearnings
मेट्रिक के साथ काम करती है.इसके अलावा,
earnings
मेट्रिक की परिभाषा में सुधार किया गया है, ताकि यह बताया जा सके कि इसकी वैल्यू में, Google के बेचे गए सभी विज्ञापन सोर्स के साथ-साथ गैर-विज्ञापन सोर्स से होने वाली कुल अनुमानित आय शामिल है. पहले, परिभाषा गलत तरीके से यह बताती थी कि मेट्रिक में सिर्फ़ विज्ञापन स्रोतों से होने वाली आय शामिल थी. -
primaryAdGrossRevenue
मेट्रिक अब काम नहीं करती. इसके बजाय, रेवेन्यू का डेटा वापस पाने के लिएgrossRevenue
मेट्रिक का इस्तेमाल करें. -
अब काम नहीं कर रही
primaryAdGrossRevenue
मेट्रिक के अलावा, विज्ञापन की परफ़ॉर्मेंस रिपोर्ट भीmonetizedPlaybacks
औरplaybackBasedCpm
मेट्रिक के साथ काम नहीं करती हैं. हालांकि, कई वीडियो रिपोर्ट में अब भी ये मेट्रिक उपलब्ध हैं. -
एपीआई अब वीडियो रिपोर्ट के लिए दो नई मेट्रिक,
videosAddedToPlaylists
औरvideosRemovedFromPlaylists
के साथ काम करता है. चैनल और कॉन्टेंट के मालिकों, दोनों के लिए वीडियो रिपोर्ट की सूचियां अपडेट कर दी गई हैं, ताकि नई मेट्रिक के हिसाब से रिपोर्ट की पहचान की जा सके.videosAddedToPlaylists
– क्वेरी के दायरे में आने वाले वीडियो को किसी भी YouTube प्लेलिस्ट में जोड़े जाने की संख्या. शायद वीडियो, वीडियो के मालिक की प्लेलिस्ट या किसी दूसरे चैनल की प्लेलिस्ट में जोड़े गए हों.videosRemovedFromPlaylists
– क्वेरी के दायरे में आने वाले वीडियो को किसी भी YouTube प्लेलिस्ट से हटाए जाने की संख्या. ऐसा हो सकता है कि वीडियो को, वीडियो के मालिक की प्लेलिस्ट या किसी दूसरे चैनल की प्लेलिस्ट से हटा दिया गया हो.
दोनों मेट्रिक में, "बाद में देखें" जैसी डिफ़ॉल्ट प्लेलिस्ट शामिल होती है. हालांकि, वे उन प्लेलिस्ट की गिनती नहीं करते जिनमें कोई वीडियो अपने-आप जुड़ जाता है. जैसे, किसी चैनल की अपलोड की गई प्लेलिस्ट या उपयोगकर्ता का वीडियो देखने का इतिहास. यह भी ध्यान रखें कि ये मेट्रिक, जोड़े और मिटाए गए आइटम की कुल संख्या दिखाती हैं. इसलिए, अगर कोई उपयोगकर्ता किसी प्लेलिस्ट में कोई वीडियो जोड़ता है और उसे हटाकर, फिर से जोड़ता है, तो मेट्रिक से पता चलता है कि वह वीडियो दो प्लेलिस्ट में जोड़ा गया था और उसे एक प्लेलिस्ट से हटा दिया गया था.
इन मेट्रिक के लिए 1 अक्टूबर, 2014 तक का डेटा उपलब्ध है.
-
इस एलान के बाद,
favoritesAdded
औरfavoritesRemoved
मेट्रिक के इस्तेमाल पर रोक लगा दी गई है. ये दोनों मुख्य मेट्रिक हैं. साथ ही, सेवा की शर्तों में बताई गई, सेवा बंद करने की नीति के मुताबिक हैं. -
नए
currency
पैरामीटर की मदद से, आय की मेट्रिक को डॉलर (USD
) के बजाय किसी दूसरी मुद्रा में पाया जा सकता है. अगर पैरामीटर को सेट किया जाता है, तो एपीआईearnings
,grossRevenue
,playbackBasedCpm
, औरimpressionBasedCpm
मेट्रिक की वैल्यू को बताई गई मुद्रा में बदल देता है. नतीजे में मिलने वाली वैल्यू का हिसाब, मुद्रा बदलने की दरों के आधार पर लगाया जाता है. ये एक्सचेंज रेट के हिसाब से, हर दिन बदलते हैं.पैरामीटर वैल्यू, तीन अक्षरों वाला ISO 4217 मुद्रा कोड होती है. डिफ़ॉल्ट वैल्यू
USD
है. पैरामीटर की परिभाषा में, इस्तेमाल किए जा सकने वाले मुद्रा कोड की सूची शामिल होती है. -
एपीआई अब 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 सहायता केंद्र पर जाएं.
-
-
एपीआई अब
show
डाइमेंशन के साथ काम नहीं करता. -
फ़िल्टर के तौर पर इस्तेमाल किए जाने पर अब एपीआई,
video
,playlist
,channel
, औरshow
डाइमेंशन के लिए एक से ज़्यादा वैल्यू तय करने की सुविधा देता है. एक से ज़्यादा वैल्यू तय करने के लिएfilters
पैरामीटर की वैल्यू को उस वीडियो, प्लेलिस्ट, चैनल, या शो आईडी की कॉमा-सेपरेटेड लिस्ट में सेट करें जिसके लिए एपीआई के रिस्पॉन्स को फ़िल्टर किया जाना चाहिए. पैरामीटर वैल्यू में 200 आईडी तक तय किए जा सकते हैं.अगर एक ही फ़िल्टर के लिए कई वैल्यू तय की जाती हैं, तो उस फ़िल्टर को डाइमेंशन की सूची में भी जोड़ा जा सकता है. यह तब भी लागू होता है, जब फ़िल्टर को किसी रिपोर्ट के लिए इस्तेमाल किए जा सकने वाले डाइमेंशन के तौर पर शामिल न किया गया हो. अगर डाइमेंशन की सूची में फ़िल्टर जोड़ा जाता है, तो एपीआई भी नतीजों को ग्रुप करने के लिए, फ़िल्टर वैल्यू का इस्तेमाल करता है.
इस सुविधा के बारे में पूरी जानकारी पाने के लिए,
filters
पैरामीटर की परिभाषा देखें. -
चैनल की रिपोर्ट हासिल करते समय, अब
ids
पैरामीटर की वैल्यू कोchannel==MINE
पर सेट करके, उसके चैनल का डेटा वापस पाया जा सकता है. ऐसा, पुष्टि किए गए उपयोगकर्ता के चैनल का डेटा पाने के लिए किया जाता है. किसी खास चैनल का डेटा पाने के लिए, अब भीids
पैरामीटर कोchannel==CHANNEL_ID
पर सेट किया जा सकता है. -
API अब प्लेलिस्ट रिपोर्ट का समर्थन करता है, जिनमें प्लेलिस्ट के संदर्भ में होने वाले वीडियो व्यू से संबंधित आंकड़े होते हैं. प्लेलिस्ट से जुड़ी रिपोर्ट, चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं.
सभी प्लेलिस्ट की रिपोर्ट में,
views
औरestimatedMinutesWatched
मेट्रिक का इस्तेमाल किया जा सकता है. साथ ही, कुछ रिपोर्ट मेंaverageViewDuration
मेट्रिक का भी इस्तेमाल किया जा सकता है.इसके अलावा, सभी प्लेलिस्ट की रिपोर्ट में नीचे दिए गए नए मेट्रिक इस्तेमाल किए जा सकते हैं. ध्यान दें कि इनमें से हर मेट्रिक सिर्फ़ वेब पर मिले प्लेलिस्ट व्यू को दिखाती है.
playlistStarts
: दर्शकों ने प्लेलिस्ट को कितनी बार चलाया.viewsPerPlaylistStart
: हर बार प्लेलिस्ट शुरू करने पर वीडियो देखे जाने की औसत संख्या.averageTimeInPlaylist
: प्लेलिस्ट शुरू होने के बाद, किसी दर्शक ने प्लेलिस्ट में वीडियो देखे जाने का अनुमानित औसत समय (मिनट में).
प्लेलिस्ट की रिपोर्ट पाने के किसी भी अनुरोध के लिए,
isCurated
फ़िल्टर का इस्तेमाल करना ज़रूरी है. यह फ़िल्टर1
(isCurated==1
) पर सेट होना चाहिए. -
इस एपीआई में अब दर्शक बनाए रखने की रिपोर्ट काम करती है. इस रिपोर्ट की मदद से, यह आकलन किया जाता है कि कोई वीडियो अपने दर्शकों को बनाए रखता है या नहीं. रिपोर्ट का नया
elapsedVideoTimeRatio
डाइमेंशन, मेट्रिक की इन वैल्यू के लिए बीते हुए वीडियो को मेज़र करता है:-
audienceWatchRatio
मेट्रिक, वीडियो में बताए गए पॉइंट पर वीडियो देखने वाले दर्शकों के पूरे अनुपात की पहचान करती है. इस अनुपात का हिसाब, वीडियो के किसी हिस्से को देखे जाने की संख्या और वीडियो के कुल व्यू से तुलना करके लगाया जाता है.ध्यान रखें कि दिए गए वीडियो व्यू में, वीडियो के किसी हिस्से को एक से ज़्यादा बार देखा जा सकता है या एक बार भी नहीं देखा जा सकता. उदाहरण के लिए, अगर उपयोगकर्ता किसी वीडियो के एक ही हिस्से को कई बार पीछे करके देखते हैं, तो वीडियो के उस हिस्से का कुल अनुपात
1
से ज़्यादा हो सकता है. -
relativeRetentionPerformance
मेट्रिक से पता चलता है कि किसी वीडियो को, एक जैसी अवधि वाले दूसरे सभी वीडियो के मुकाबले कितनी अच्छी तरह देखा जाता है. अगर वैल्यू 0 है, तो इसका मतलब है कि कोई वीडियो, मिलती-जुलती अवधि वाले दूसरे वीडियो के मुकाबले दर्शकों को खराब रखता है. वहीं, एक वैल्यू का मतलब है कि दर्शक उस वीडियो से मिलती-जुलती अवधि वाले दूसरे वीडियो के मुकाबले ज़्यादा दर्शकों को अपने साथ जोड़े रखते हैं. वहीं, 0.5 मीडियन वैल्यू का मतलब है कि मिलती-जुलती अवधि वाले आधे वीडियो, दर्शकों को बनाए रखते हैं. वहीं, आधे वीडियो को खराब दर्शक बनाए रखते हैं.
audienceType
फ़िल्टर का भी इस्तेमाल किया जा सकता है, ताकि रिपोर्ट सिर्फ़ ऑर्गैनिक व्यू, TrueView इन-स्ट्रीम विज्ञापनों से या TrueView इन-डिसप्ले विज्ञापनों से मिले व्यू से जुड़ा डेटा दिखाए. (ऑर्गैनिक व्यू, उपयोगकर्ता की कार्रवाई का सीधा नतीजा होते हैं. जैसे, वीडियो के लिए खोज करना या सुझाए गए किसी वीडियो पर क्लिक करना.) -
-
यह एपीआई, एनोटेशन से जुड़ी कई नई मेट्रिक के साथ काम करता है. नीचे दी गई मेट्रिक को ऐसी किसी भी रिपोर्ट से हासिल किया जा सकता है जिसमें पहले
annotationClickThroughRate
औरannotationCloseRate
मेट्रिक के साथ काम करता था.annotationImpressions
: एनोटेशन इंप्रेशन की कुल संख्या.annotationClickableImpressions
: दिखाई गई और क्लिक की जा सकने वाली टिप्पणियों की संख्या.annotationClosableImpressions
: दिखाई गई और बंद की जा सकने वाली टिप्पणियों की संख्या.annotationClicks
: क्लिक की गई एनोटेशन की कुल संख्या.annotationCloses
: बंद एनोटेशन की कुल संख्या.
सभी नई मेट्रिक, मुख्य मेट्रिक होती हैं और इन पर रोक लगाने की नीति लागू होती है. हालांकि, ध्यान रखें कि नई मेट्रिक के लिए 16 जुलाई, 2013 से डेटा उपलब्ध है. (
annotationClickThroughRate
औरannotationCloseRate
मेट्रिक के लिए 10 जून, 2012 तक का डेटा उपलब्ध है.) -
GOOGLE_SEARCH
को अबinsightTrafficSourceType
डाइमेंशन के लिए, किसी अलग वैल्यू के तौर पर रिपोर्ट नहीं किया जाता. इसके बजाय, Google पर खोज नतीजों से मिलने वाले रेफ़रल को अबEXT_URL
तरह के ट्रैफ़िक सोर्स के डेटा में शामिल किया जाएगा. इस वजह से, अब ऐसीinsightTrafficSourceDetail
रिपोर्ट को वापस नहीं पाया जा सकता जोinsightTrafficSourceType
फ़िल्टर कोGOOGLE_SEARCH
पर सेट करती है. -
कॉन्टेंट के मालिक की रिपोर्ट वाले दस्तावेज़ को अपडेट कर दिया गया है. इससे यह पता चलता है कि कॉन्टेंट के मालिक ने जिस कॉन्टेंट पर दावा किया है या उसे अपलोड किया है उसके लिए,
subscribersGained
औरsubscribersLost
मेट्रिक को अब फिर से हासिल किया जा सकता है.यह बदलाव कॉन्टेंट के मालिकों के लिए, बुनियादी आंकड़े वाली पहली रिपोर्ट में दिखता है. इस रिपोर्ट पर अब
claimedStatus
औरuploaderType
फ़िल्टर काम करते हैं. -
सैंपल अनुरोध दस्तावेज़ को फिर से डिज़ाइन किया गया है, ताकि कैटगरी के हिसाब से ग्रुप के उदाहरण दिए जा सकें. इसमें चैनल और कॉन्टेंट के मालिक की रिपोर्ट के लिए हाल ही में रिलीज़ किए गए टैब फ़ॉर्मैट से मिलता-जुलता टैब फ़ॉर्मैट इस्तेमाल किया गया है. नए डिज़ाइन में, उदाहरणों को इन कैटगरी में बांटा गया है:
- बुनियादी आंकड़े
- समय के हिसाब से
- भौगोलिक
- वीडियो चलाने की जगह
- ट्रैफ़िक सोर्स
- डिवाइस/ओएस
- डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह)
- सोशल
- आय/विज्ञापन (सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट के लिए)
-
अनुरोधों के नमूने दस्तावेज़ में अब चैनल रिपोर्ट या कॉन्टेंट के मालिक की रिपोर्ट में, प्रांत के हिसाब से डेटा पाने के नए उदाहरण शामिल किए गए हैं.
-
अमेरिका के राज्यों और वॉशिंगटन डी॰सी॰ के लिए, प्रांत के हिसाब से मेट्रिक: इस रिपोर्ट में, किसी चैनल के वीडियो पर मिले व्यू की संख्या और अन्य आंकड़ों का डेटा, हर प्रांत के हिसाब से उपलब्ध कराया जाता है. इस डेटा में अमेरिका के राज्यों और वॉशिंगटन डीसी का डेटा शामिल है. इस उदाहरण में,
province
डाइमेंशन का इस्तेमाल किया गया है. साथ ही,filters
पैरामीटर का इस्तेमाल करके रिस्पॉन्स को सिर्फ़ अमेरिका के नतीजों को शामिल करने तक सीमित किया गया है. -
कैलिफ़ोर्निया में दर्शकों की डेमोग्राफ़िक्स (उम्र और लिंग, आय, शिक्षा वगैरह): इस रिपोर्ट से, कैलिफ़ोर्निया में किसी चैनल के वीडियो देखने वाले दर्शकों के उम्र समूह और लिंग के बारे में जानकारी मिलती है. इसके अलावा, कॉन्टेंट के मालिक की ओर से दावा किए गए कॉन्टेंट से जुड़ी रिपोर्ट भी मिलती हैं. इस उदाहरण में,
filters
पैरामीटर का इस्तेमाल करके यह पक्का किया जाता है कि रिस्पॉन्स में सिर्फ़ किसी एक प्रांत का डेटा शामिल हो.
-
-
province
डाइमेंशन की परिभाषा को अपडेट किया गया है. इससे यह पता चलेगा कि जबdimensions
पैरामीटर वैल्यू मेंprovince
को शामिल किया जाता है, तो अनुरोध मेंfilters
पैरामीटर वैल्यू मेंcountry==US
को शामिल करके, डेटा को अमेरिका तक सीमित भी किया जाना चाहिए. -
कॉन्टेंट के मालिक और चैनल की रिपोर्ट वाले दस्तावेज़ों को फिर से डिज़ाइन किया गया है. सभी संभावित रिपोर्ट को शामिल करने वाली टेबल देने के बजाय, हर दस्तावेज़, रिपोर्ट को कैटगरी में बांट देता है:
- बुनियादी आंकड़े
- समय के हिसाब से
- भौगोलिक
- वीडियो चलाने की जगह
- ट्रैफ़िक सोर्स
- डिवाइस/ओएस
- डेमोग्राफ़िक (उम्र, लिंग, आय, शिक्षा वगैरह)
- सोशल
- सबसे ज़्यादा देखे गए वीडियो
हर दस्तावेज़ इन कैटगरी को टैब की सूची के तौर पर दिखाता है और किसी भी टैब पर क्लिक करके उस कैटगरी में काम करने वाली रिपोर्ट देखी जा सकती हैं.
-
एपीआई में अब तीन नए भौगोलिक डाइमेंशन इस्तेमाल किए जा सकते हैं:
province
,continent
, औरsubContinent
.-
province
डाइमेंशन की मदद से, अमेरिका और कोलंबिया डिस्ट्रिक्ट के आंकड़े हासिल किए जा सकते हैं. इस डाइमेंशन के दो तरीके इस्तेमाल किए जा सकते हैं:-
यह एपीआई दो रिपोर्ट के साथ काम करता है. इनमें अलग-अलग राज्यों के हिसाब से आंकड़ों को बांटा जाता है. दोनों रिपोर्ट चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं.
- आंकड़ों की मुख्य रिपोर्ट में कई आंकड़े होते हैं. इनमें, वीडियो को मिले व्यू की संख्या और वीडियो देखे जाने के अनुमानित मिनट जैसी जानकारी शामिल होती है.
- समय-आधारित रिपोर्ट वही आंकड़े उपलब्ध कराती है, लेकिन इसमें रोज़ाना, 7 दिन, 30 दिन या हर महीने के हिसाब से डेटा इकट्ठा करती है.
-
filters
क्वेरी पैरामीटर का इस्तेमाल करके, रिपोर्ट में किसी खास स्थिति के आंकड़े देखे जा सकते हैं. कई रिपोर्ट इस तरह की फ़िल्टर करने की सुविधा के साथ काम करती हैं. इनमें भौगोलिक रिपोर्ट, वीडियो चलाने की जगह की रिपोर्ट, ट्रैफ़िक सोर्स की रिपोर्ट, डिवाइस की रिपोर्ट, ऑपरेटिंग सिस्टम की रिपोर्ट, डेमोग्राफ़िक रिपोर्ट, और टॉप वीडियो रिपोर्ट शामिल हैं.
-
-
continent
डाइमेंशन, संयुक्त राष्ट्र (यूएन) के सांख्यिकीय क्षेत्र के कोड के बारे में बताता है, जो किसी महाद्वीप की पहचान करता है. इस डाइमेंशन का इस्तेमाल, सिर्फ़ फ़िल्टर के तौर पर किया जा सकता है. -
subContinent
डाइमेंशन से, संयुक्त राष्ट्र (यूएन) के आंकड़ों वाले क्षेत्र के कोड के बारे में पता चलता है, जो किसी महाद्वीप के उप-क्षेत्र की पहचान करता है. इस डाइमेंशन का इस्तेमाल, सिर्फ़ फ़िल्टर के तौर पर किया जा सकता है.हर उप-इलाका सिर्फ़ एक महाद्वीप से जुड़ा होता है. इसलिए,
subContinent
फ़िल्टर का इस्तेमाल करते समय,continent
फ़िल्टर का इस्तेमाल करने की ज़रूरत नहीं है. (असल में, अगर किसी अनुरोध में दोनों डाइमेंशन का इस्तेमाल किया जाता है, तो एपीआई गड़बड़ी का मैसेज दिखाएगा.)
-
-
दस्तावेज़ में सुधार किया गया है, ताकि
insightTrafficSourceDetail
डाइमेंशन में,insightTrafficSourceType
की वैल्यूPROMOTED
को मान्य फ़िल्टर वैल्यू के तौर पर शामिल न किया जा सके. -
अब YouTube Analytics API पर, सेवा की शर्तों में बताई गई, सेवा बंद करने की नीति लागू होगी. हालांकि, एपीआई के नॉन-कोर डाइमेंशन और नॉन-कोर मेट्रिक पर, एपीआई को बंद करने की नीति लागू नहीं होती. मुख्य डाइमेंशन और मुख्य मेट्रिक की सूची बनाने के लिए, डाइमेंशन और metrics पेजों को अपडेट किया गया है. इसके अलावा, मुख्य डाइमेंशन और मेट्रिक की साफ़ तौर पर पहचान करने के लिए, उन पेजों पर मौजूद परिभाषाओं को अपडेट किया गया है.
-
एपीआई अब
insightPlaybackLocationType
डाइमेंशन की वैल्यू के तौर पर,EXTERNAL_APP
का इस्तेमाल करता है. इस अपडेट के साथ ही, 10 सितंबर, 2013 से चलाए गए वीडियो,MOBILE
वाले वीडियो की कैटगरी में नहीं रखे जाएंगे. हालांकि, इस तारीख से पहले चलाए गए वीडियो, इसी वैल्यू के हिसाब से कैटगरी में रखे जाएंगे.इस अपडेट के बाद, मोबाइल पर वीडियो चलाने की सुविधा को
WATCH
,EMBEDDED
याEXTERNAL_APP
में से किसी एक कैटगरी में रखा जाएगा. यह कैटगरी इस हिसाब से तय होगी कि वीडियो किस टाइप के हैं. -
एपीआई अब
insightTrafficSourceType
डाइमेंशन की वैल्यू के तौर पर,PLAYLIST
का इस्तेमाल करता है. इस वैल्यू से पता चलता है कि वीडियो पर मिले व्यू किसी प्लेलिस्ट से मिले थे. पहले, इन व्यू को डाइमेंशन कीYT_OTHER_PAGE
कैटगरी का इस्तेमाल करके बांटा जाता था. -
इस एपीआई में अब कई डाइमेंशन और मेट्रिक के हिसाब से, रिपोर्ट को क्रम से लगाया जा सकता है. अनुरोध के सैंपल में, एक से ज़्यादा डाइमेंशन/मेट्रिक के हिसाब से अनुरोधों को क्रम से लगाने का एक नया उदाहरण दिया गया है. यह इस सुविधा को दिखाता है. अनुरोध, ट्रैफ़िक सोर्स के डेटा को फिर से हासिल करता है और इसकी
sort
पैरामीटर वैल्यूday,-views
होती है. नतीजों को समय के हिसाब से क्रम में लगाया जाता है, लेकिन हर दिन के लिए सेट किए गए नतीजों में, पहली लाइन में सबसे ज़्यादा व्यू जनरेट करने वाले ट्रैफ़िक सोर्स का डेटा शामिल होता है. दूसरी लाइन में सबसे ज़्यादा व्यू जनरेट करने वाले सोर्स का डेटा शामिल होता है. इसी तरह, हर दिन के हिसाब से सेट किए गए नतीजों में, सबसे ज़्यादा व्यू जनरेट करने वाले सोर्स का डेटा शामिल होता है. -
यह एपीआई अब दो नए डाइमेंशन
deviceType
औरoperatingSystem
के साथ काम करता है. इनका इस्तेमाल उन डिवाइसों का डेटा हासिल करने के लिए किया जा सकता है जिन पर दर्शक आपके वीडियो देख रहे हैं. एपीआई उन रिपोर्ट का इस्तेमाल करता है जिनमें दोनों डाइमेंशन में से किसी एक या दोनों का इस्तेमाल किया गया हो.-
deviceType
की रिपोर्ट की मदद से, अलग-अलग तरह के डिवाइसों पर मिले व्यू की संख्या और उन्हें देखे जाने का अनुमानित समय पता लगाया जा सकता है. इनमें डेस्कटॉप, मोबाइल, और टैबलेट डिवाइस शामिल हैं. डिवाइस टाइप रिपोर्ट को सीमित करने के लिए भीoperatingSystem
फ़िल्टर का इस्तेमाल किया जा सकता है. इस रिपोर्ट में, सिर्फ़ खास ऑपरेटिंग सिस्टम वाले डिवाइसों, जैसे कि Android या iOS के आंकड़े शामिल किए जा सकते हैं. -
operatingSystem
की रिपोर्ट से, आपको अलग-अलग ऑपरेटिंग सिस्टम, जैसे कि Android, iOS, Linux वगैरह पर वीडियो को मिले व्यू की संख्या और देखने के कुल समय का अनुमान पाने में मदद मिलती है. ऑपरेटिंग सिस्टम रिपोर्ट को मोबाइल डिवाइस या टैबलेट जैसे सिर्फ़ खास तरह के डिवाइस के आंकड़े देखने के लिए सीमित करने के लिए,deviceType
फ़िल्टर का इस्तेमाल भी किया जा सकता है.
डिवाइस के नए टाइप और ऑपरेटिंग सिस्टम की रिपोर्ट, चैनलों और कॉन्टेंट के मालिकों के लिए उपलब्ध हैं.
-
-
चैनलों के लिए तीन डिवाइस रिपोर्ट और कॉन्टेंट के मालिकों के लिए तीन डिवाइस रिपोर्ट शामिल करने के लिए, अनुरोधों के सैंपल वाले दस्तावेज़ को अपडेट किया गया है.
-
insightPlaybackLocationType
डाइमेंशन से,YT_OTHER
वैल्यू मिल सकती है. इससे उन व्यू की पहचान होती है जिन्हें किसी डाइमेंशन की दूसरी वैल्यू का इस्तेमाल करके नहीं बांटा गया है. -
कॉन्टेंट के मालिक की रिपोर्ट से जुड़े दस्तावेज़ को अपडेट कर दिया गया है. इससे यह पता चलता है कि सबसे ज़्यादा कमाई करने वाले वीडियो की रिपोर्ट को घटते क्रम में लगाया जा सकता है. ऐसा करके, सबसे ज़्यादा कमाई वाले वीडियो की पहचान की जा सकती है. यह रिपोर्ट, उपयोगकर्ता गतिविधि और आय की रिपोर्ट सेक्शन की दूसरी टेबल में पहली टेबल है.
-
YouTube, अब प्रयोग के तौर पर शुरू की गई एपीआई सुविधाओं और सेवाओं की पहचान नहीं करता. इसके बजाय, अब हम पाबंदी वाले YouTube API के लिए बनी नीति की सूची उपलब्ध कराते हैं.
-
इस एपीआई में अब अन्य मेट्रिक के साथ-साथ, देखने के कुल समय की मेट्रिक –
estimatedMinutesWatched
,averageViewDuration
, औरaverageViewPercentage
को भी हासिल किया जा सकता है. इन मेट्रिक में, व्यू मेट्रिक, यूज़र ऐक्टिविटी वाली मेट्रिक, कमाई की मेट्रिक, और विज्ञापन की परफ़ॉर्मेंस दिखाने वाली मेट्रिक भी शामिल हैं.इस बदलाव को दिखाने के लिए, उपलब्ध चैनल की रिपोर्ट और कॉन्टेंट के मालिक से जुड़ी रिपोर्ट की सूचियां अपडेट कर दी गई हैं. (ये सूचियां अब और छोटी हो गई हैं, क्योंकि देखे जाने के कुल समय की मेट्रिक को दूसरी सूची में शामिल रिपोर्ट के हिस्से के तौर पर फिर से पाया जा सकता है.)
एपीआई अनुरोधों के सैंपल वाले दस्तावेज़ को भी अपडेट कर दिया गया है.
-
insightPlaybackLocationDetail
औरinsightTrafficSourceDetail
डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट को इन तरीकों से बेहतर बनाया गया है:-
अब उन पर एक वैकल्पिक
country
फ़िल्टर काम करता है. -
कॉन्टेंट के मालिक अब
filter
के इनमें से किसी भी नए कॉम्बिनेशन का इस्तेमाल करके, ये रिपोर्ट फिर से हासिल कर सकते हैं. ध्यान दें कि ये सभी कॉम्बिनेशन, वैकल्पिकcountry
फ़िल्टर के साथ भी काम करते हैं.-
वीडियो चलाने की जगह की जानकारी
channel,insightPlaybackLocationType==EMBEDDED
show,insightPlaybackLocationType==EMBEDDED
claimedStatus,insightPlaybackLocationType==EMBEDDED
uploaderType,insightPlaybackLocationType==EMBEDDED
uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED
-
ट्रैफ़िक सोर्स की जानकारी
channel,insightTrafficSourceType
show,insightTrafficSourceType
claimedStatus,insightTrafficSourceType
uploaderType,insightTrafficSourceType
uploaderType,claimedStatus,insightTrafficSourceType
-
-
-
नए सैंपल एपीआई अनुरोधों वाले दस्तावेज़ में, ऐसे उदाहरण दिए गए हैं जिनमें यह बताया गया है कि YouTube Analytics API का इस्तेमाल करके, अलग-अलग तरह की रिपोर्ट को कैसे वापस पाया जा सकता है. हर उदाहरण में, अनुरोध में शामिल रिपोर्ट के बारे में कम शब्दों में जानकारी दी जाती है. इसके बाद, अनुरोध के लिए डाइमेंशन, मेट्रिक, फ़िल्टर, और क्रम से लगाने के पैरामीटर दिखाए जाते हैं.
-
insightTrafficSourceType
डाइमेंशन में, अब मान्य वैल्यू के तौर परSUBSCRIBER
का इस्तेमाल किया जा सकता है. इस वैल्यू से उन वीडियो व्यू की पहचान होती है जो YouTube के होम पेज पर मौजूद फ़ीड या YouTube की सदस्यता वाली सुविधाओं से रेफ़र किए गए हैं. अगर इस ट्रैफ़िक सोर्स के आधार पर फ़िल्टर लगाया जाता है, तोinsightTrafficSourceDetail
फ़ील्ड होम पेज फ़ीड या किसी दूसरे पेज के बारे में जानकारी देगा, जिससे व्यू रेफ़र किए गए थे. -
एपीआई अब दो नई मेट्रिक,
annotationClickThroughRate
औरannotationCloseRate
के साथ काम करता है. ये मेट्रिक, आपके वीडियो के दौरान दिखने वाली एनोटेशन के साथ दर्शकों के इंटरैक्शन से जुड़ी हैं. चैनल की रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट, दोनों को अपडेट कर दिया गया है, ताकि नई मेट्रिक के साथ काम करने वाली रिपोर्ट की पहचान की जा सके.annotationClickThroughRate
– दर्शकों ने जिन एनोटेशन पर क्लिक किया और क्लिक किए जा सकने वाले एनोटेशन इंप्रेशन की कुल संख्या का अनुपात, उनका अनुपात है.annotationCloseRate
– एनोटेशन इंप्रेशन की कुल संख्या के साथ दर्शकों की ओर से बंद की गई टिप्पणियों का अनुपात.
-
एपीआई अब आय और विज्ञापन की परफ़ॉर्मेंस से जुड़ी मेट्रिक के साथ-साथ, विज्ञापन की नई परफ़ॉर्मेंस रिपोर्ट का इस्तेमाल करता है. इन सभी मेट्रिक और रिपोर्ट को सिर्फ़ वे 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
के नए स्कोप का इस्तेमाल करके ऐक्सेस देने की अनुमति देता है.
-
-
एपीआई दस्तावेज़ को फिर से व्यवस्थित किया गया है, ताकि अलग-अलग तरह की रिपोर्ट के बारे में अलग-अलग पेजों पर जानकारी दी जा सके. इसलिए, अब अलग-अलग पेज हैं. इनमें अलग-अलग तरह की चैनल रिपोर्ट और कॉन्टेंट के मालिक की रिपोर्ट के बारे में बताया गया है.
-
एपीआई की रेफ़रंस गाइड में अब एक उदाहरण सेक्शन मौजूद है. इसमें उन कोड सैंपल को शामिल किया गया है जो Java, JavaScript, Python, और Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करके, एपीआई को कॉल करने का तरीका बताते हैं. JavaScript कोड वही सैंपल है जिसके बारे में सैंपल ऐप्लिकेशन के दस्तावेज़ में बताया गया है.
-
एपीआई की रेफ़रंस गाइड में अब APIs Explorer की सुविधा है. इसकी मदद से, एपीआई को कॉल किया जा सकता है, एपीआई अनुरोध देखा जा सकता है, और रिस्पॉन्स के हिसाब से असल डेटा हासिल किया जा सकता है.
-
यह एपीआई, चैनलों और कॉन्टेंट के मालिकों, दोनों के लिए कई नई रिपोर्ट की सुविधा देता है. इनके बारे में नीचे बताया गया है. हर रिपोर्ट, चैनल की रिपोर्ट या कॉन्टेंट के मालिक की रिपोर्ट के तौर पर उपलब्ध होती है. डाइमेंशन और metrics पेजों को भी उसी हिसाब से अपडेट कर दिया गया है.
-
वीडियो चलाने की जगह की रिपोर्ट से, अलग-अलग तरह के पेजों या ऐप्लिकेशन पर वीडियो व्यू की संख्या के बारे में पता चलता है.
-
वीडियो चलाने की जगह की ज़्यादा जानकारी वाली रिपोर्ट, एम्बेड किए गए उन प्लेयर की पहचान करती है जिन्होंने किसी खास वीडियो के लिए सबसे ज़्यादा व्यू जनरेट किए. यह वीडियो चलाने की जगह की रिपोर्ट की तुलना में, ज़्यादा बारीकी से जानकारी देता है. इसके लिए, ये टॉप एम्बेड किए गए प्लेयर से जुड़े यूआरएल की पहचान करते हैं.
-
ट्रैफ़िक सोर्स रिपोर्ट की मदद से, अलग-अलग तरह के रेफ़रर से मिले वीडियो व्यू की संख्या का पता चलता है.
-
ट्रैफ़िक सोर्स की ज़्यादा जानकारी वाली रिपोर्ट से, उन रेफ़रर की पहचान होती है जिन्होंने किसी वीडियो और किसी खास तरह के ट्रैफ़िक सोर्स के लिए सबसे ज़्यादा व्यू जनरेट किए हैं. उदाहरण के लिए, इस रिपोर्ट से उन मिलते-जुलते वीडियो की पहचान की जा सकती है जिनकी वजह से किसी वीडियो पर सबसे ज़्यादा ट्रैफ़िक आया. यह रिपोर्ट, कई ट्रैफ़िक सोर्स के लिए काम करती है.
-
देखने के कुल समय की रिपोर्ट से पता चलता है कि दर्शकों ने आपका कॉन्टेंट कितने समय तक देखा. रिपोर्ट किसी खास समय अवधि, जैसे कि दिन, पिछले सात दिन, पिछले 30 दिन वगैरह के लिए डेटा इकट्ठा कर सकती है. अगर किसी रिपोर्ट में दिन या देश के हिसाब से डेटा इकट्ठा किया जाता है, तो रिपोर्ट में हर वीडियो व्यू की औसत अवधि के साथ-साथ, यह भी पता चल सकता है कि उपयोगकर्ताओं ने कितने वीडियो देखे.
-
-
YouTube Analytics API अब सभी डेवलपर के लिए उपलब्ध है. APIs console में सेवाएं पैनल में जाकर, अपने प्रोजेक्ट के लिए इस एपीआई को चालू किया जा सकता है. इसके लिए, आपको पहले ऐक्सेस का अनुरोध करने की ज़रूरत नहीं होती.
-
नया इस्तेमाल शुरू करना सेक्शन, YouTube Analytics API का इस्तेमाल करने वाला ऐप्लिकेशन बनाने की ज़रूरी शर्तों और बुनियादी चरणों के बारे में बताता है.
-
कोटा के इस्तेमाल को समझना सेक्शन में, एपीआई कोटा के इस्तेमाल को ऑप्टिमाइज़ करने से जुड़े दिशा-निर्देश दिए गए हैं. एपीआई सर्वर हर अनुरोध के लिए क्वेरी की लागत का हिसाब लगाता है और यह लागत आपके एपीआई इस्तेमाल करने के कोटा से काट ली जाती है. अलग-अलग तरह की रिपोर्ट में क्वेरी की लागत काफ़ी अलग हो सकती है. इसलिए, आपको अपने कोटे का बेहतर तरीके से इस्तेमाल करना चाहिए. साथ ही, आपके ऐप्लिकेशन को सिर्फ़ उन मेट्रिक और डेटा के लिए अनुरोध करना चाहिए जिनकी उसे वाकई ज़रूरत है.
-
टेंप्लेट डाइमेंशन सेक्शन को अपडेट किया गया है, ताकि यह बताया जा सके कि उन डाइमेंशन से पता चलता है कि Analytics रिपोर्ट में, समयावधि के मुताबिक डेटा इकट्ठा होना चाहिए. यह एपीआई अब यहां दिए गए अन्य अस्थायी डाइमेंशन के साथ काम करता है:
7DayTotals
– रिपोर्ट में डेटा इकट्ठा किया जाएगा, ताकि हर पंक्ति में सात दिनों की अवधि का डेटा शामिल हो.30DayTotals
– रिपोर्ट में डेटा इकट्ठा किया जाएगा, ताकि हर लाइन में 30 दिन की अवधि का डेटा शामिल हो.month
– रिपोर्ट में हर महीने के हिसाब से डेटा इकट्ठा किया जाएगा.
इसी तरह, उपलब्ध रिपोर्ट सेक्शन को अपडेट किया गया है, ताकि यह दिखाया जा सके कि इन डाइमेंशन का इस्तेमाल करने वाली रिपोर्ट में एपीआई की सुविधा कैसे काम करती है.
-
रिपोर्टिंग इकाई के डाइमेंशन सेक्शन को अपडेट किया गया है. इसमें बताया गया है कि कॉन्टेंट के मालिक की रिपोर्ट पाने के एपीआई अनुरोधों को, इनमें से किसी एक डाइमेंशन (
video
,channel
याshow
) याclaimedStatus
औरuploaderType
डाइमेंशन के साथ काम करने वाले कॉम्बिनेशन का इस्तेमाल करके डेटा फ़िल्टर करना होगा. -
एपीआई में अब टॉप-वीडियो रिपोर्ट को क्रम से लगाने के दो नए विकल्प काम करते हैं. चैनल की रिपोर्ट या कॉन्टेंट के मालिक की रिपोर्ट के तौर पर उपलब्ध इन रिपोर्ट में, हर देश के हिसाब से मेट्रिक (व्यू, टिप्पणियां, पसंद वगैरह) शामिल होती हैं और इन मेट्रिक को वीडियो के हिसाब से बांटा जाता है. अब इन रिपोर्ट को वीडियो के वॉच पेज से, किसी चैनल की सदस्यता लेने वाले या सदस्यता छोड़ने वाले लोगों की संख्या के हिसाब से क्रम में लगाया जा सकता है.
-
subscribersGained
औरsubscribersLost
metrics की परिभाषाएं अपडेट की गई हैं. ऐसा इसलिए किया गया है, ताकि यह बताया जा सके कि किसी चैनल के सदस्यों की संख्या कई जगहों पर बढ़ या घट सकती है. इन जगहों में वीडियो वॉच पेज, चैनल पेज, और YouTube होम पेज पर दिखने वाली गाइड शामिल है. जब ये मेट्रिक, किसी वीडियो की खास रिपोर्ट में दिखती हैं, तो उनमें सिर्फ़ खास वीडियो के वॉच पेज के आंकड़े शामिल होते हैं.
YouTube Reporting API, तीन नई एंड स्क्रीन रिपोर्ट के साथ काम करता है. साथ ही, इन रिपोर्ट के लिए नए डाइमेंशन और मेट्रिक का इस्तेमाल भी किया जा सकता है. इन रिपोर्ट में, वीडियो के रुकने के बाद दिखने वाली एंड स्क्रीन के लिए, इंप्रेशन और क्लिक मिलने की दर (सीटीआर) के आंकड़े होते हैं.
YouTube सहायता केंद्र पर, अपने वीडियो में एंड स्क्रीन जोड़ने के बारे में ज़्यादा जानकारी पाएं.
8 नवंबर, 2016
इस अपडेट के तहत, YouTube Analytics API में ये बदलाव किए गए हैं:
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 में ये बदलाव शामिल हैं:
19 अगस्त, 2016
इस अपडेट में, YouTube Reporting API में ये बदलाव शामिल हैं:
11 अगस्त, 2016
इस अपडेट में ये बदलाव शामिल हैं:
10 अगस्त, 2016
इस अपडेट में ये बदलाव शामिल हैं:
18 जुलाई, 2016
इस अपडेट में ये बदलाव शामिल हैं:
28 जून, 2016
कई चैनल और कॉन्टेंट के मालिक की रिपोर्ट में, कार्ड मेट्रिक से जुड़ी सहायता दिखाने के लिए, YouTube Analytics API से जुड़े दस्तावेज़ को अपडेट किया गया है. इन नई मेट्रिक का इस्तेमाल किया जा सकता है:
ये मेट्रिक, इस तरह की रिपोर्ट में इस्तेमाल की जा सकती हैं:
22 जून, 2016
इस अपडेट में, YouTube Reporting API में ये बदलाव शामिल हैं. पहला बदलाव एपीआई से जुड़ा है और बाकी बदलाव सिर्फ़ कॉन्टेंट के मालिक की रिपोर्ट पर असर डालते हैं:
19 मई, 2016
इस अपडेट में, YouTube Reporting API में ये बदलाव शामिल हैं:
12 अप्रैल, 2016
इस अपडेट में नीचे दिए गए बदलाव शामिल हैं, जो सिर्फ़ YouTube Reporting API पर असर डालते हैं:
28 मार्च, 2016
YouTube Reporting API और YouTube Analytics API, अब शेयर की जाने वाली कई अतिरिक्त सेवाओं को देखे जाने के आंकड़े दिखाते हैं.
16 मार्च, 2016
इस अपडेट में नीचे दिए गए बदलाव शामिल हैं, जिनका असर YouTube Reporting API और YouTube Analytics API, दोनों पर पड़ेगा:
YouTube Reporting API
YouTube Analytics एपीआई
8 फ़रवरी, 2016
YouTube Analytics API पर काम करने वाली मेट्रिक की सूची अपडेट कर दी गई है. अब कार्ड मेट्रिक, उस एपीआई पर काम करने वाली मेट्रिक के तौर पर नहीं दिखेंगी. (उस एपीआई की किसी भी रिपोर्ट में, किसी भी कार्ड मेट्रिक के साथ काम करने वाला दस्तावेज़ नहीं है.)
ध्यान दें कि अब भी YouTube Reporting API का इस्तेमाल करके, कार्ड मेट्रिक हासिल की जा सकती हैं. YouTube Reporting API की मदद से, कई चैनल और कॉन्टेंट के मालिक की रिपोर्ट के लिए, ये मेट्रिक इस्तेमाल की जा सकती हैं.
6 जनवरी, 2016
YouTube Reporting API और YouTube Analytics API, अब खास तौर पर Chromecast डिवाइस पर मिलने वाले व्यू की पहचान करते हैं.
21 दिसंबर, 2015
दस्तावेज़ में, annotation_clickable_impressions
और annotation_closable_impressions
मेट्रिक के नाम अपडेट किए गए हैं, ताकि रिपोर्ट में दिखने वाले नामों से मैच किया जा सके. पहले, नामों को clickable_annotation_impressions
और closable_annotation_impressions
के तौर पर दर्ज किया जाता था.
18 दिसंबर, 2015
यूरोपीय संघ (ईयू) के कानूनों के मुताबिक, असली उपयोगकर्ताओं को जानकारी ज़ाहिर करने के साथ-साथ उनके लिए सहमति लेना भी ज़रूरी है. इसलिए, यूरोपीय संघ के असली उपयोगकर्ताओं के लिए, आपको ईयू उपयोगकर्ता की सहमति से जुड़ी नीति का पालन करना होगा. हमने YouTube API की सेवा की शर्तों में, इस ज़रूरी शर्त के बारे में एक सूचना जोड़ी है.
15 दिसंबर, 2015
इस अपडेट में नीचे दिए गए बदलावों के बारे में बताया गया है. इनका असर YouTube Analytics API पर पड़ेगा:
10 नवंबर, 2015
इस अपडेट में ये बदलाव शामिल हैं:
29 अक्टूबर, 2015
इस अपडेट में ये बदलाव शामिल हैं:
8 अक्टूबर, 2015
इस अपडेट में ये बदलाव शामिल हैं:
24 सितंबर, 2015
इस अपडेट में ये बदलाव शामिल हैं:
20 अगस्त, 2015
इस अपडेट में ये बदलाव शामिल हैं:
22 जुलाई, 2015
इस अपडेट में कई बदलाव शामिल हैं, जो सिर्फ़ कॉन्टेंट के मालिकों पर लागू होते हैं:
1 जून, 2015
इस अपडेट में ये बदलाव शामिल हैं:
31 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
16 मार्च, 2015
इस अपडेट में ये बदलाव शामिल हैं:
25 फ़रवरी, 2015
इस अपडेट में ये बदलाव शामिल हैं:
13 फ़रवरी, 2015
इस अपडेट में ये बदलाव शामिल हैं:
28 अगस्त, 2014
इस अपडेट में ये बदलाव शामिल हैं:
16 जुलाई, 2014
इस अपडेट में ये बदलाव शामिल हैं:
31 जनवरी, 2014
इस अपडेट में ये बदलाव शामिल हैं:
16 जनवरी, 2014
इस अपडेट में ये बदलाव शामिल हैं:
6 जनवरी, 2014
इस अपडेट में ये बदलाव शामिल हैं:
30 सितंबर, 2013
इस अपडेट में ये बदलाव शामिल हैं:
16 जुलाई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
23 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
10 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
6 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
3 मई, 2013
इस अपडेट में ये बदलाव शामिल हैं:
28 मार्च, 2013
इस अपडेट में ये बदलाव शामिल हैं:
21 मार्च, 2013
इस अपडेट में ये बदलाव शामिल हैं:
4 फ़रवरी, 2013
इस अपडेट में ये बदलाव शामिल हैं:
14 नवंबर, 2012
इस अपडेट में ये बदलाव शामिल हैं:
2 अक्टूबर, 2012
इस अपडेट में ये बदलाव शामिल हैं:
12 सितंबर, 2012
इस अपडेट में ये बदलाव शामिल हैं: