Reports API एक RESTful API है. इसका इस्तेमाल करके, अपने उपयोगकर्ताओं की Google Workspace गतिविधियों की जानकारी ऐक्सेस की जा सकती है. Reports API, Admin SDK API का हिस्सा है.
Reports API दो तरह की रिपोर्ट उपलब्ध कराता है:
- गतिविधि रिपोर्ट, जो किसी खास ऐप्लिकेशन या सेवा के लिए इवेंट की जानकारी देती हैं. जैसे, Google Drive या Admin console.
- इस्तेमाल की रिपोर्ट, जिनमें उपयोगकर्ताओं की वजह से हुए Workspace इवेंट की सूची होती है.
- ग्राहक के इस्तेमाल की रिपोर्ट में, आपके डोमेन के सभी उपयोगकर्ताओं के इवेंट की सूची होती है.
- उपयोगकर्ता के इस्तेमाल की रिपोर्ट में, उपयोगकर्ता के हिसाब से व्यवस्थित किए गए इवेंट की सूची होती है.
Reports API में इस्तेमाल होने वाले सामान्य शब्दों की सूची यहां दी गई है:
- गतिविधि की रिपोर्ट
गतिविधि की रिपोर्ट में, किसी Google Workspace ऐप्लिकेशन या सेवा में की गई गतिविधियों की जानकारी होती है. गतिविधि की रिपोर्ट में तारीख, समय, उपयोगकर्ता, और गतिविधि का टाइप शामिल होता है. एपीआई रेफ़रंस में, गतिविधि रिपोर्ट और उनमें शामिल जानकारी की पूरी सूची होती है. यहां ऐप्लिकेशन या सेवा के हिसाब से, गतिविधि रिपोर्ट के कुछ उदाहरण दिए गए हैं:
- एडमिन गतिविधि रिपोर्ट में, Admin console का इस्तेमाल करके एडमिन की गतिविधियां दिखती हैं. उदाहरण के लिए, आपको उन सभी मौकों की सूची मिल सकती है जब एडमिन ने Admin console का इस्तेमाल करके, किसी उपयोगकर्ता का नाम बदला है.
- Google Drive की गतिविधि की रिपोर्ट से पता चलता है कि आपके डोमेन के उपयोगकर्ता, Drive के दस्तावेज़ों में कैसे बदलाव करते हैं और उन्हें कैसे देखते हैं. उदाहरण के लिए, आपको Drive पर किसी उपयोगकर्ता की गतिविधि की सूची मिल सकती है.
- लॉगिन गतिविधि की रिपोर्ट से यह जानकारी मिलती है कि आपके खाते के उपयोगकर्ता, अपने खातों में कब लॉग इन और लॉग आउट करते हैं. उदाहरण के लिए, किसी खास समयावधि के दौरान अपने डोमेन के लिए किए गए सभी लॉगिन की रिपोर्ट देखी जा सकती है.
- मोबाइल गतिविधि की रिपोर्ट, Google Mobile Management से मैनेज किए जाने वाले मोबाइल डिवाइसों का इस्तेमाल करके की गई गतिविधियां दिखाती हैं. उदाहरण के लिए, जब उपयोगकर्ता कोई नया डिवाइस रजिस्टर करते हैं, तो आपको इसकी सूचना मिल सकती है.
- OAuth टोकन की गतिविधि की रिपोर्ट में, ऐसे इवेंट की सूची होती है जिनमें आपके उपयोगकर्ताओं ने तीसरे पक्ष की वेबसाइटों और ऐप्लिकेशन के इस्तेमाल किए जाने वाले अनुमति टोकन दिए हैं या रद्द किए हैं. Reports API का इस्तेमाल करके, किसी उपयोगकर्ता के Google Workspace डेटा को ऐक्सेस करने वाले तीसरे पक्ष की सभी कंपनियों की सूची देखी जा सकती है.
- इस्तेमाल से जुड़ी रिपोर्ट
इस्तेमाल की रिपोर्ट से, आपके डोमेन में Google Workspace के इवेंट के बारे में जानकारी मिलती है. उपयोगकर्ताओं के बारे में खास जानकारी का अनुरोध करने के लिए, एपीआई का इस्तेमाल किया जा सकता है.
- ग्राहकों के इस्तेमाल से जुड़ी रिपोर्ट, आपके खाते में ऐप्लिकेशन और सेवा की गतिविधियों की पूरी जानकारी दिखाती हैं. इस्तेमाल से जुड़ी इस जानकारी को ऐप्लिकेशन के टाइप के हिसाब से व्यवस्थित किया जाता है. इसमें उस ऐप्लिकेशन से जुड़ी खास जानकारी शामिल होती है.
- उपयोगकर्ताओं के इस्तेमाल की रिपोर्ट, आपके खाते के उपयोगकर्ताओं की गतिविधियां दिखाती हैं. इन रिपोर्ट को अपनी पसंद के मुताबिक बनाया जा सकता है और इस्तेमाल से जुड़ी खास जानकारी के लिए फ़िल्टर किया जा सकता है. इस्तेमाल से जुड़ी यह जानकारी, ऐप्लिकेशन के टाइप के हिसाब से व्यवस्थित की जाती है. साथ ही, इसमें उस ऐप्लिकेशन से जुड़ी खास जानकारी होती है.
- इकाइयों के इस्तेमाल की रिपोर्ट में, उन इकाइयों से जुड़ी गतिविधियों की सूची होती है जिनका इस्तेमाल आपके खाते के उपयोगकर्ताओं ने Currents ऐप्लिकेशन में किया है.
- सूचनाएं
- Reports API, सूचनाएं देता है. इनसे आपको इवेंट पर नज़र रखने में मदद मिलती है. जैसे, संसाधनों में हुए बदलाव. जब किसी संसाधन को देखा जा रहा हो और उसमें बदलाव हो जाए, तो Reports API आपको सूचना भेजता है. Reports API को सेट अप करने और इससे सूचनाएं पाने के बारे में ज़्यादा जानने के लिए, पुश नोटिफ़िकेशन पाने की गाइड देखें.
अगले चरण
Reports API के बारे में जानने और यह देखने के लिए कि यह कैसे काम करता है, क्विकस्टार्ट का इस्तेमाल करें. ये क्विकस्टार्ट, बाईं ओर मौजूद नेविगेशन बार में प्रोग्रामिंग भाषा के हिसाब से दिखते हैं. अपने खाते को सेट अप करने के बारे में सामान्य जानकारी पढ़ने के लिए, इस सेक्शन को पढ़ना जारी रखा जा सकता है.
अनुमति सेक्शन में, Google Workspace के ऐप्लिकेशन और सेवाओं से उपयोगकर्ता का डेटा पाने के लिए, OAuth 2.0 ऐक्सेस टोकन इस्तेमाल करने का तरीका बताया गया है.
किसी खास तरह के संसाधन या तरीके के बारे में जानकारी पाने के लिए, एपीआई का रेफ़रंस देखें.
ज़्यादा जानकारी के लिए, Admin SDK API की समस्याओं को ट्रैक करने वाला टूल, Google Workspace डेवलपर ब्लॉग, और Google Workspace Admin सहायता केंद्र देखें.