इस दस्तावेज़ में, कोर रिपोर्टिंग और मेटाडेटा एपीआई के लिए, डेटा का इस्तेमाल रोकने की नीति के बारे में बताया गया है.
खास जानकारी
डाइमेंशन और मेट्रिक (कॉलम) का इस्तेमाल, Google Analytics Reporting API की क्वेरी करने के लिए किया जाता है. कभी-कभी इन कॉलम को जोड़ना, हटाना या इनके नाम बदलना ज़रूरी होता है. डेटा का इस्तेमाल रोकने की नीति से, इस बारे में ज़्यादा जानकारी मिलती है कि ये बदलाव किस तरह से लागू होते हैं.
कॉलम में होने वाले सभी बदलावों की जानकारी बदलाव लॉग की मदद से दी जाएगी. साथ ही, मेटाडेटा एपीआई इन बदलावों को दिखाने के लिए अपने-आप अपडेट हो जाएगा.
इस नीति में क्या-क्या शामिल है
इस नीति में, सार्वजनिक एपीआई की मदद से दिखाए गए डाइमेंशन और मेट्रिक के बारे में जानकारी दी गई है. इसमें, एपीआई अनुरोध (क्वेरी पैरामीटर), एपीआई से मिले रिस्पॉन्स, एपीआई से मिली वैल्यू या डाइमेंशन और मेट्रिक के मान्य कॉम्बिनेशन शामिल नहीं होते हैं.
नया डेटा
एपीआई में नए कॉलम जोड़े जाने पर:
- इससे जुड़े एपीआई के बदलाव लॉग को नए कॉलम की जानकारी के साथ अपडेट किया जाएगा.
- कॉलम Metadata API में उपलब्ध होंगे.
डेटा निकालना
एपीआई से कॉलम हटाए जाने पर:
- इससे जुड़े एपीआई के बदलाव लॉग को, हटाए गए कॉलम की जानकारी के साथ अपडेट किया जाएगा.
- Metadata API में, कॉलम
status
एट्रिब्यूट कोDEPRECATED
पर सेट किया जाएगा. - रिपोर्टिंग क्वेरी में कॉलम, कम से कम छह महीने तक काम करते रहेंगे.
- छह महीने के बाद, कॉलम को Metadata API से हटा दिया जाएगा.
रिपोर्टिंग एपीआई में कॉलम की क्वेरी करने पर,
400 Bad Request
गड़बड़ी दिखेगी.
डेटा का नाम बदलना
कॉलम के नाम बदले जाने पर:
- इससे जुड़े एपीआई के बदलाव लॉग को मूल और बदले जाने वाले कॉलम की जानकारी के साथ अपडेट किया जाएगा.
- Metadata API
में, मूल कॉलम का
status
एट्रिब्यूट,DEPRECATED
पर सेट किया जाएगा. साथ ही,replacedBy
एट्रिब्यूट को बदले जाने वाले कॉलम के आईडी पर सेट किया जाएगा. - मूल कॉलम, रिपोर्टिंग क्वेरी में कम से कम छह महीने तक काम करते रहेंगे.
- छह महीने के बाद, Metadata API से मूल कॉलम हटा दिए जाएंगे.
रिपोर्टिंग एपीआई में कॉलम की क्वेरी करने पर,
400 Bad Request
गड़बड़ी दिखेगी.
एट्रिब्यूट हटाना
मेटाडेटा एपीआई से एट्रिब्यूट हटाए जाने पर:
- Metadata API के बदलाव का लॉग उस एट्रिब्यूट की जानकारी के साथ अपडेट किया जाएगा जिसे हटाया जा रहा है.
- एट्रिब्यूट, कम से कम छह महीने तक मेटाडेटा एपीआई में उपलब्ध रहेंगे.
- छह महीने के बाद, Metadata API से एट्रिब्यूट हटा दिए जाएंगे.
ग्रुप
कभी-कभी, किसी ग्रुप का नाम या कॉलम का क्रम बदलना ज़रूरी होता है. ऐसा होने पर:
- Metadata API के बदलाव का लॉग में, ग्रुप के नाम और ऑर्डर में हुए बदलावों की जानकारी शामिल की जाएगी.