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