Google Analytics APIs के लिए, डेटा रोकने की नीति

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

खास जानकारी

डाइमेंशन और मेट्रिक (कॉलम) का इस्तेमाल, Google Analytics Reporting API से क्वेरी करने के लिए किया जाता है. कभी-कभी इन कॉलम को जोड़ना, हटाना या उनके नाम बदलना ज़रूरी हो जाता है. डेटा के इस्तेमाल को रोकने की नीति से, इस बारे में ज़्यादा जानकारी मिलती है कि ये बदलाव कैसे होते हैं.

कॉलम में हुए सभी बदलावों की जानकारी, चेंजलॉग से दी जाएगी. साथ ही, मेटाडेटा एपीआई में ये बदलाव अपने-आप अपडेट हो जाएंगे.

इस नीति में क्या-क्या शामिल है

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

नया डेटा

एपीआई में नए कॉलम जोड़ने पर:

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

डेटा हटाना

एपीआई से कॉलम हटाए जाने पर:

  • इससे जुड़े एपीआई के चेंजलॉग को हटाए जाने वाले कॉलम की जानकारी के साथ अपडेट किया जाएगा.
  • मेटाडेटा API में, कॉलम status एट्रिब्यूट को DEPRECATED पर सेट किया जाएगा.
  • ये कॉलम, रिपोर्टिंग क्वेरी में कम से कम छह महीने तक काम करते रहेंगे.
  • कॉलम को छह महीने बाद, मेटाडेटा एपीआई से हटा दिया जाएगा और Reporting API में कॉलम की क्वेरी करने पर, 400 Bad Request की गड़बड़ी दिखेगी.

डेटा का नाम बदलना

कॉलम के नाम बदले जाने पर:

  • इससे जुड़े एपीआई के चेंजलॉग में, ओरिजनल और रीप्लेसमेंट कॉलम की जानकारी अपडेट की जाएगी.
  • मेटाडेटा एपीआई में मूल कॉलम का status एट्रिब्यूट, DEPRECATED पर और replacedBy एट्रिब्यूट, बदले जाने वाले कॉलम के आईडी पर सेट किया जाएगा.
  • ओरिजनल कॉलम, कम से कम छह महीने तक रिपोर्टिंग क्वेरी में काम करते रहेंगे.
  • छह महीने बाद, मेटाडेटा एपीआई से ओरिजनल कॉलम हटा दिए जाएंगे और Reporting API में कॉलम की क्वेरी करने पर 400 Bad Request की गड़बड़ी दिखेगी.

एट्रिब्यूट हटाना

मेटाडेटा एपीआई से एट्रिब्यूट हटाए जाने पर:

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

ग्रुप

कभी-कभी किसी ग्रुप का नाम या कॉलम के क्रम को बदलना ज़रूरी होता है. जब ऐसा होता है, तो: