इस दस्तावेज़ में, Google Analytics के मेटाडेटा एपीआई की खास जानकारी दी गई है. एपीआई की ज़्यादा जानकारी के लिए, एपीआई का रेफ़रंस पढ़ें.
शुरुआती जानकारी
Metadata API, Google Analytics Reporting API में दिखाए गए कॉलम (जैसे, डाइमेंशन और मेट्रिक) की सूची और एट्रिब्यूट दिखाता है. दिखाए गए एट्रिब्यूट में यूज़र इंटरफ़ेस (यूआई) का नाम, ब्यौरा, सेगमेंट से जुड़ी सहायता वगैरह शामिल है.
Metadata API का इस्तेमाल इन कामों के लिए किया जा सकता है:
- नए कॉलम अपने आप खोजें
- Google Analytics Reporting API के लिए सभी डाइमेंशन और मेट्रिक एट्रिब्यूट को ऐक्सेस करना
मेटाडेटा एपीआई से जुड़ा लाइव रिस्पॉन्स देखें. साथ ही, डेवलपर गाइड को पढ़कर जानें कि इसका इस्तेमाल कैसे किया जा सकता है.
कॉन्सेप्ट के बारे में खास जानकारी
Metadata API के बुनियादी सिद्धांत:
कॉलम
Metadata API में मौजूद कॉलम रिसॉर्स, किसी एक डाइमेंशन या मेट्रिक को दिखाता है.
साथ ही, उसमें उस कॉलम के लिए Id और दूसरे
एट्रिब्यूट जैसी जानकारी मौजूद होती है. Column संसाधनों का कलेक्शन,
Reporting API के सभी डाइमेंशन और मेट्रिक दिखाता है.
एपीआई का इस्तेमाल करना
एपीआई से क्वेरी करते समय, उस रिपोर्ट टाइप के बारे में बताया जाता है जिसका मेटाडेटा वापस पाना है. एपीआई से मिलने वाले रिस्पॉन्स में, उस रिपोर्ट टाइप के लिए उपलब्ध सभी कॉलम (जैसे, डाइमेंशन और मेट्रिक) का कलेक्शन शामिल होगा. एपीआई से मिले रिस्पॉन्स और कोड के उदाहरणों के बारे में ज़्यादा जानने के लिए, मेटाडेटा एपीआई की रेफ़रंस गाइड पढ़ें. साथ ही, एपीआई के साथ काम करने से जुड़ी जानकारी के लिए, Metadata API Dev गाइड पढ़ें.
API (एपीआई) ऐक्सेस
Metadata API को पुष्टि करने और अनुमति देने की ज़रूरत नहीं होती. इसके बजाय, सिर्फ़ यह ज़रूरी है कि जब भी आपका ऐप्लिकेशन Analytics API को अनुरोध भेजें, तब वह अपनी पहचान करे. ऐसा करने का तरीका जानने के लिए, डेव गाइड का एपीआई ऐक्सेस सेक्शन देखें.
कोटा और रोकने की नीतियां
Metadata API, लाखों कामों को मैनेज करता है. सिस्टम को ज़रूरत से ज़्यादा कार्रवाइयां करने से बचाने के लिए, कोटा सिस्टम इस्तेमाल करना ज़रूरी है. इससे यह भी पक्का होता है कि सिस्टम के संसाधनों को समान तरीके से बांटा जाए. ज़्यादा जानकारी के लिए, सीमा और कोटा से जुड़ी गाइड पढ़ें.
रिपोर्टिंग एपीआई कॉलम (जैसे, डाइमेंशन और मेट्रिक) में किए गए बदलावों को कैसे मैनेज किया जाता है, इस बारे में ज़्यादा जानने के लिए, डेटा रोकने की नीति पढ़ें. यह जानने के लिए कि Metadata API का इस्तेमाल, काम न करने वाले कॉलम की जांच करने के लिए कैसे किया जा सकता है. इसके लिए, Metadata API Dev गाइड देखें.