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