Google Analytics मैनेजमेंट एपीआई चेंजलॉग

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

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

मिलते-जुलते बदलावलॉग की सदस्यता लें

Google Analytics API के सभी बदलावों का लॉग
–
सदस्यता लें rss

इसमें कलेक्शन, कॉन्फ़िगरेशन, और रिपोर्टिंग के सभी एपीआई शामिल हैं.

सभी कॉन्फ़िगरेशन एपीआई बदलावलॉग
–
सदस्यता लें rss

इसमें Management API और प्रॉविज़निंग एपीआई शामिल है.

मैनेजमेंट एपीआई चेंजलॉग
–
सदस्यता लें rss

मैनेजमेंट एपीआई में hashClientId वाला तरीका जोड़ा गया

hashClientId का इस्तेमाल करने पर, किसी क्लाइंट आईडी का हैश किया जा सकता है. यह डेटा एक्सपोर्ट किए गए कुछ डेटा फ़ॉर्मैट में मौजूद होता है. जैसे, BigQuery में एक्सपोर्ट किया गया Google Analytics का डेटा.

Management API में उपयोगकर्ता के डेटा के रखरखाव की सेटिंग

अब Webप्रॉपर्टी के संसाधन में जोड़े गए नए 'dataRetrieveTtl' और 'dataResourceResetOnNewActivity' के फ़ील्ड का इस्तेमाल करके, उपयोगकर्ता के डेटा के रखरखाव की सेटिंग को प्रोग्राम के हिसाब से कॉन्फ़िगर किया जा सकता है.

Management API में कार्रवाइयां लिखें

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

रीमार्केटिंग ऑडियंस - ऑप्टिमाइज़ सहायता

इस रिलीज़ में, लिंक किए गए विज्ञापन खाते के टाइप के तौर पर Google Optimize, OPTIMIZE के लिए सहायता जोड़ी गई है. ज़्यादा जानकारी के लिए, रीमार्केटिंग ऑडियंस रेफ़रंस दस्तावेज़ और रीमार्केटिंग ऑडियंस डेवलपर गाइड देखें.

रीमार्केटिंग ऑडियंस

इस रिलीज़ के ज़रिए, रीमार्केटिंग ऑडियंस संसाधन में DELETE क्रिया जोड़ी जाती है. ज़्यादा जानकारी के लिए, रीमार्केटिंग ऑडियंस डेवलपर गाइड देखें.

कस्टम मेट्रिक

यह बग समाधान रिलीज़ है; यह min_value सेट न होने के दौरान TIME प्रकार की कस्टम मेट्रिक बनाने में विफल होने की समस्या को हल करता है. min_value के बिना अनुरोध करने पर, अब 0 के डिफ़ॉल्ट min_value वाली कस्टम मेट्रिक बनाई जाती है.

मुद्राएं

यह गड़बड़ी ठीक करने के लिए रिलीज़ की गई रिलीज़ है. यह ऐसी समस्या को ठीक करती है जिसमें मुद्राओं के सबसेट की सुविधा Analytics वेब इंटरफ़ेस में काम करती थी, लेकिन API में नहीं. इस रिलीज़ में, इन मुद्राओं के लिए सहायता जोड़ी गई है:

  • यूक्रेनियन रिव्निया, एईडी, बीओबी, सीएलपी, कोलंबियन पेसो, क्रोएशियन कुना, इज़रायली न्यू शेकेल, मोरक्कन दिरहम, पेरूवियन सोल, PKR, RON, RSD, एसएआर, SGD, VEF, LVL

ज़्यादा जानकारी के लिए देखें: - व्यू (प्रोफ़ाइल) रेफ़रंस. - सहायता केंद्र में मुद्रा का रेफ़रंस लेख.

यह रिलीज़, Management API में रीमार्केटिंग ऑडियंस को जोड़ती है.

रीमार्केटिंग ऑडियंस

मैनेजमेंट एपीआई की मदद से, किसी Google Analytics प्रॉपर्टी के लिए create, get, list, update, और patch रीमार्केटिंग ऑडियंस बनाई जा सकती हैं. रीमार्केटिंग ऑडियंस के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, Analytics में रीमार्केटिंग ऑडियंस के बारे में जानकारी वाला सहायता केंद्र का लेख पढ़ें.

गड़बड़ी की दर को सीमित किया जा रहा है

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

  • हर घंटे 50 ईमेल लिखने के अनुरोध पूरे नहीं किए जा सके.

नमूनारहित रिपोर्ट

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

नमूनारहित रिपोर्ट

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

देखे जाने की संख्या (प्रोफ़ाइल)

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

नमूनारहित रिपोर्ट

यह रिलीज़, पूरे डेटा पर आधारित रिपोर्ट में delete तरीका जोड़ती है. ज़्यादा जानकारी के लिए, पूरे डेटा पर आधारित रिपोर्ट के लिए, रेफ़रंस दस्तावेज़ मिटाएं देखें.

सेगमेंट

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

सेगमेंट

यह गड़बड़ी ठीक करने के लिए रिलीज़ किया गया है. इस रिलीज़ से उस समस्या को ठीक किया गया है जिसकी वजह से, कई व्यू (प्रोफ़ाइलों) पर पिन किए गए निजी सेगमेंट वाले उपयोगकर्ताओं को सेगमेंट की सूची वाले तरीके को कॉल करते समय, 500 की गड़बड़ी का जवाब मिलेगा.

बैचिंग

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

देखे जाने की संख्या (प्रोफ़ाइल)

इस रिलीज़ के साथ, व्यू (प्रोफ़ाइल) currency प्रॉपर्टी अब डिफ़ॉल्ट रूप से USD पर सेट हो जाएगी, अगर डालें की कार्रवाई के दौरान सेट नहीं की जाती है. साथ ही, get और list कार्रवाइयों से, ऐसे व्यू (प्रोफ़ाइल) पर डॉलर दिखेंगे जो पहले currency प्रॉपर्टी के बिना बनाए गए थे.

फ़िल्टर

इस रिलीज़ से, अब काम नहीं करने वाले फ़िल्टर फ़ील्ड IS_MOBILE और IS_TABLET को पूरी तरह से हटा दिया जाएगा. इन्हें DEVICE_CATEGORY=mobile और DEVICE_CATEGORY=tablet से बदला जाना चाहिए. IS_MOBILE और IS_TABLET का इस्तेमाल करने के लिए फ़िल्टर फ़ील्ड सेट करने वाले अनुरोधों को डालें, अपडेट करें, और पैच करें. इससे आपको गड़बड़ी का मैसेज मिलेगा.

फ़िल्टर

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

  • मैनेजमेंट एपीआई में फ़िल्टर का इस्तेमाल करने के बारे में जानने के लिए, कृपया फ़िल्टर डेवलपर गाइड पढ़ें.

  • फ़िल्टर संसाधन के पैरामीटर की पूरी सूची देखने के लिए, कृपया फ़िल्टर रेफ़रंस देखें.

लक्ष्य

इस रिलीज़ में उस समस्या को भी ठीक किया गया है जो "comparisonValue": "0" के साथ लक्ष्य बनाने के दौरान नहीं हो पाती है.

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

  • लक्ष्य संसाधन के लिए पैरामीटर की पूरी सूची के लिए, कृपया लक्ष्य संदर्भ देखें.

इस रिलीज़ में, dailyUpload संसाधन को आखिरी बार अस्वीकार कर दिया गया है और हटाया गया है. dailyUpload संसाधन को 20 जून, 2014 को आधिकारिक रूप से बहिष्कृत कर दिया गया था; अब सभी लागत डेटा आयात अपलोड संसाधन का उपयोग करके किया जाना चाहिए.

इस रिलीज़ में, Management API में दो नए कलेक्शन जोड़े गए हैं, कस्टम डाइमेंशन और कस्टम मेट्रिक.

कस्टम डाइमेंशन और मेट्रिक

मैनेजमेंट एपीआई की मदद से अब कस्टम डाइमेंशन और मेट्रिक बनाए जा सकते हैं, लिस्ट किए जा सकते हैं, पाए जा सकते हैं, पैच किए जा सकते हैं, और अपडेट किए जा सकते हैं.

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

गड़बड़ी ठीक करना

  • समस्या 467 से जुड़ी समस्या हल करना - सेगमेंट कलेक्शन की मदद से, अब ऐसे सेगमेंट दिखाए जाते हैं जो dateOfSession सिंटैक्स का इस्तेमाल करते हैं.

इस रिलीज़ में, Google Analytics Management API का नया स्कोप लॉन्च किया गया है. - analytics.manage.users.readonly - Google Analytics के उपयोगकर्ता की अनुमतियां देखें.

एक नया DEVICE_CATEGORY फ़िल्टर फ़ील्ड जोड़ दिया गया है. साथ ही, IS_MOBILE और IS_TABLET अब काम नहीं करते. DEVICE_CATEGORY=mobile और DEVICE_CATEGORY=tablet का इस्तेमाल करें.

व्यू (प्रोफ़ाइल) संसाधन में अब एक enhancedECommerceTracking प्रॉपर्टी शामिल है. इससे पता चलता है कि बेहतर ई-कॉमर्स चालू है (true) या बंद है (false).

इस रिलीज़ में, डेटा इंपोर्ट के नए टाइप और dailyUpload संसाधन का इस्तेमाल बंद किया गया है.

डेटा इंपोर्ट

अपने Google Analytics खाते में डेटा इंपोर्ट करने के लिए, Management API का इस्तेमाल करने का तरीका जानने के लिए, डेटा इंपोर्ट डेवलपर गाइड देखें.

अपलोड किए गए वीडियो

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

हर दिन के अपलोड की सुविधा बंद की जा रही है

  • dailyUpload संसाधन को अब बंद कर दिया गया है! डेटा इंपोर्ट सुविधा का इस्तेमाल करने के लिए माइग्रेट करने के बारे में ज़्यादा जानने के लिए, माइग्रेशन गाइड देखें.
  • dailyUpload संसाधन छह महीने तक काम करता रहेगा. इसके बाद, uploadType प्रॉपर्टी को analytics#dailyUploads पर सेट करने वाली बाकी customDataSources प्रॉपर्टी अपने-आप माइग्रेट हो जाएंगी और सिर्फ़ upload संसाधन के साथ काम करेंगी.
  • dailyUpload संसाधन के मौजूदा उपयोगकर्ताओं को अपना कोड अपडेट करना चाहिए और जितनी जल्दी हो सके अपलोड संसाधन का इस्तेमाल करने के लिए माइग्रेट करना चाहिए.

इस रिलीज़ में दो नए कॉन्फ़िगरेशन एपीआई जोड़े गए हैं.

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

फ़िल्टर

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

पूरे डेटा पर आधारित रिपोर्ट: मैनेजमेंट एपीआई

मैनेजमेंट एपीआई में एक नया संसाधन जोड़ा जा रहा है, जिसका नाम पूरे डेटा पर आधारित रिपोर्ट है. पूरे डेटा पर आधारित रिपोर्ट, Google Analytics (GA) की ऐसी रिपोर्ट होती हैं जिन्हें पूरे डेटा का इस्तेमाल करके जनरेट किया गया है.पूरे डेटा पर आधारित रिपोर्ट, फ़िलहाल सिर्फ़ GA Premium के उपयोगकर्ताओं के लिए उपलब्ध हैं. 

सेगमेंट: Management API v2.4 और v3.0

सेगमेंट कलेक्शन में ये बदलाव किए गए हैं:

  • उपयोगकर्ता और क्रम वाले सेगमेंट अब एपीआई में काम करते हैं.
  • सेगमेंट कलेक्शन में अब सभी बिल्ट-इन और कस्टम सेशन लेवल और उपयोगकर्ता लेवल सेगमेंट दिखते हैं.
  • सेगमेंट के लिए definition प्रॉपर्टी, अब नए सेगमेंट सिंटैक्स का इस्तेमाल करेगी. इसमें मौजूदा सेशन लेवल के सेगमेंट की परिभाषाएं भी शामिल हैं, जो definition: "" से definition: "sessions::condition::" में बदल जाएंगी.
  • सेगमेंट संसाधन में एक नई type प्रॉपर्टी जोड़ी गई है. इससे पता चलता है कि कोई सेगमेंट CUSTOM (यानी कि किसी उपयोगकर्ता ने वेब इंटरफ़ेस में बनाया है) है या BUILT_IN यानी कि Google Analytics से मिला है.

एक्सपेरिमेंट

नीचे दी गई AdSense मेट्रिक का इस्तेमाल, अब ऑप्टिमाइज़ेशन के मकसद के तौर पर किया जा सकता है:

  • ga:adsenseAdsClicks — आपकी साइट पर मौजूद AdSense विज्ञापनों पर किए गए क्लिक की संख्या.
  • ga:adsenseAdsViewed — देखे गए AdSense विज्ञापनों की संख्या. एक विज्ञापन यूनिट में एक से ज़्यादा विज्ञापन दिखाए जा सकते हैं.
  • ga:adsenseRevenue — AdSense विज्ञापनों से मिला कुल रेवेन्यू.

खाते की खास जानकारी का नया कलेक्शन

  • AccountSummaries कलेक्शन, Management API में जोड़ दिया गया है. यह एक ही अनुरोध के साथ, हर उस खाते, प्रॉपर्टी, और व्यू (प्रोफ़ाइल) की खास जानकारी देता है जिसका ऐक्सेस किसी अधिकृत उपयोगकर्ता के पास होता है. ज़्यादा जानकारी के लिए, खाते की खास जानकारी वाली डेवलपर गाइड देखें.

ga:isMobile और ga:isTablet डाइमेंशन बंद है होने की वजह से, डिफ़ॉल्ट सेगमेंट में ये बदलाव किए गए हैं:

  • सेगमेंट gaid::-11 का नाम बदलकर मोबाइल ट्रैफ़िक से मोबाइल और टैबलेट ट्रैफ़िक कर दिया गया है. इस सेगमेंट की परिभाषा को ga:isMobile==Yes से बदलकर ga:deviceCategory==mobile,ga:deviceCategory==tablet कर दिया गया है. ध्यान दें कि ga:isMobile में टैबलेट ट्रैफ़िक शामिल है, जो नई परिभाषा में दिखता है. अगर आपको टैबलेट को छोड़कर, सिर्फ़ मोबाइल ट्रैफ़िक चाहिए, तो नए मोबाइल ट्रैफ़िक सेगमेंट (gaid::-14) पर स्विच करें.
  • सेगमेंट gaid::-13 की परिभाषा ga:isTablet==Yes से बदलकर ga:deviceCategory==tablet कर दी गई है. यह टैबलेट ट्रैफ़िक के तौर पर दिखता रहेगा.
  • सेगमेंट gaid::-14 जोड़ दिया गया है. सेगमेंट का नाम मोबाइल ट्रैफ़िक है और इसकी परिभाषा ga:deviceCategory==mobile है.

गड़बड़ियां ठीक की गईं:

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

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

खाता सेटअप और कॉन्फ़िगरेशन एपीआई

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

मैनेजमेंट एपीआई में उपयोगकर्ता की अनुमतियां

  • नया accountUserLinks संसाधन, उपयोगकर्ताओं के लिए खाता अनुमतियों को मैनेज करने की सुविधा देता है.
  • नया webpropertyUserLinks संसाधन, उपयोगकर्ताओं के लिए प्रॉपर्टी अनुमतियों को मैनेज करने की सुविधा देता है.
  • नया profileUserLinks संसाधन, उपयोगकर्ताओं के लिए व्यू (प्रोफ़ाइल) अनुमतियों को मैनेज करने की सुविधा देता है.
  • अनुमति वाले उपयोगकर्ता की अनुमतियां, अब खाते, वेब प्रॉपर्टी, और व्यू (प्रोफ़ाइल) संसाधनों के हिस्से के तौर पर उपलब्ध हैं.
  • एक नया स्कोप लॉन्च किया गया है और यह उपयोगकर्ता की अनुमतियों को मैनेज करने के लिए ज़रूरी है. https://www.googleapis.com/auth/analytics.manage.users.
  • ज़्यादा जानकारी के लिए, उपयोगकर्ता अनुमतियों की डेवलपर गाइड देखें.

नए सेगमेंट के लॉन्च के तहत, हम सेगमेंट कलेक्शन में इन बदलावों को रोल आउट करेंगे:

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

इस रिलीज़ में, वेबप्रॉपर्टी संसाधन में दो नई प्रॉपर्टी जोड़ी गई हैं:

  • profileCount - इससे किसी प्रॉपर्टी के लिए प्रोफ़ाइल की संख्या की जानकारी मिलती है. इसकी मदद से, उन प्रॉपर्टी को फ़िल्टर किया जा सकता है जिनमें कोई प्रोफ़ाइल नहीं है. जैसे, ProfileCount = 0 होना चाहिए.
  • industryVertical - यह फ़ंक्शन किसी प्रॉपर्टी के लिए चुने गए इंडस्ट्री वर्टिकल/कैटगरी को दिखाता है.

गड़बड़ियां ठीक की गईं:

  • अब प्रोफ़ाइल संसाधन की eCommerceTracking प्रॉपर्टी, वेब इंटरफ़ेस के एडमिन सेक्शन में दी गई ई-कॉमर्स सेटिंग के मुताबिक है. ई-कॉमर्स ट्रैकिंग के चालू होने पर true दिखाता है और न होने पर false दिखाता है.
  • एक्सपेरिमेंट के संसाधनों को ऐक्सेस करने और उनमें बदलाव करने के लिए, Management API v3 में एक नया एंडपॉइंट जोड़ा गया.
  • प्रोफ़ाइल संसाधन में अब एक type प्रॉपर्टी शामिल है, जिससे यह पता चलता है कि प्रोफ़ाइल को किसी वेबसाइट या ऐप्लिकेशन के लिए कॉन्फ़िगर किया गया है या नहीं. दो संभावित वैल्यू, WEB या APP हैं.

इस रिलीज़ में, Management API में गड़बड़ी से जुड़े काम के जवाब शामिल किए गए हैं.

  • एपीआई से जुड़ी गड़बड़ी के जवाबों के मुख्य हिस्से में गड़बड़ी के नए कोड, वजहें, और जानकारी जोड़ी गई है. मैनेजमेंट एपीआई के वर्शन 2.4 और वर्शन 3.0, दोनों वर्शन के लिए सभी कोड दर्ज किए गए हैं.

इस रिलीज़ में डेटा जोड़ा गया है, मौजूदा फ़ंक्शन में बदलाव किया गया है, और गड़बड़ी ठीक की गई है.

नया डेटा

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

बदलाव

  • max-results के डेटा टाइप को integer में बदल दिया गया है.

  • max-results की डिफ़ॉल्ट और ज़्यादा से ज़्यादा वैल्यू को बदलकर 1000 कर दिया गया है.

गड़बड़ी ठीक करना

  • Google वेबसाइट अनुकूलक प्रयोगों के खाते, वेब प्रॉपर्टी, और प्रोफ़ाइल अब उनसे संबंधित संग्रहों में शामिल नहीं किए जाते.

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

वर्शन 3.0

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

  • नया डेटा

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

  • बदलाव

    • नई कोटा नीति
    • एपीआई ऐक्सेस को मैनेज करने और ज़्यादा कोटा का अनुरोध करने के लिए, Google API (एपीआई) कंसोल के साथ इंटिग्रेशन
    • उपयोगकर्ताओं को अनुमति देने के नए और सुझाए गए तरीके के तौर पर, OAuth 2.0 की सुविधा
    • अनुरोध करने के लिए नया यूआरएल: https://www.googleapis.com/analytics/v3/management/…
    • JSON का इस्तेमाल करके ज़्यादा कॉम्पैक्ट एपीआई रिस्पॉन्स
    • नई Google API क्लाइंट लाइब्रेरी, जो कई और भाषाओं का समर्थन करती हैं
    • Google Discovery API के लिए सहायता

वर्शन 2.4

  • यह एक माइनर वर्शन अपग्रेड है, जो ज़्यादातर पुराने वर्शन के साथ काम करता है.

  • बदलाव

    • नई कोटा नीति
    • एपीआई ऐक्सेस को मैनेज करने और ज़्यादा कोटा का अनुरोध करने के लिए, Google API (एपीआई) कंसोल के साथ इंटिग्रेशन
    • अनुमति देने के मौजूदा तरीकों और OAuth 2.0 के साथ लगातार काम करने की सुविधा
    • अनुरोध करने के लिए नया यूआरएल: https://www.googleapis.com/analytics/v2.4/management/…
    • जवाब सिर्फ़ एक्सएमएल में दिए गए हैं
    • Google डेटा JavaScript क्लाइंट लाइब्रेरी के लिए कोई सहायता नहीं
    • एक्सएमएल आउटपुट, वर्शन 2.3 के जैसा है, ताकि Google डेटा की अन्य मौजूदा क्लाइंट लाइब्रेरी काम करती रहेंगी.

बंद किया गया

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

यह Google Analytics Management API का बीटा रिलीज़ है!

नए फ़ीड

अपडेट की गई क्लाइंट लाइब्रेरी

  • Management API को उसी लाइब्रेरी में रिलीज़ किया जा रहा है जिसमें Google Analytics Data Export API मौजूद है. Google Data Java और JavaScript लाइब्रेरी, दोनों अपडेट हो गई हैं. लाइब्रेरी के getManagementFeed() तरीके से सही फ़ीड यूआरआई तय करके, हर फ़ीड को ऐक्सेस किया जा सकता है.

नए दस्तावेज़

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