Reports API की खास जानकारी

Reports API, एक RESTफ़ुल एपीआई है जिसका इस्तेमाल, अपने उपयोगकर्ताओं की Google Workspace गतिविधियों के बारे में जानकारी ऐक्सेस करने के लिए किया जा सकता है. Reports API, Admin SDK API का हिस्सा है.

Reports API दो तरह की रिपोर्ट उपलब्ध कराता है:

  • गतिविधि रिपोर्ट, जो किसी ऐप्लिकेशन या सेवा जैसे कि Google Drive या Admin console के लिए इवेंट की रिपोर्ट करती हैं.
  • इस्तेमाल की रिपोर्ट, जिनमें उपयोगकर्ताओं की वजह से वर्कस्पेस से जुड़े इवेंट की सूची होती है.
    • ग्राहक के इस्तेमाल की रिपोर्ट में, आपके डोमेन के सभी उपयोगकर्ताओं के इवेंट की सूची दी जाती है.
    • उपयोगकर्ता के इस्तेमाल की रिपोर्ट में, उपयोगकर्ता के हिसाब से व्यवस्थित किए गए इवेंट की सूची होती है.

Reports API में इस्तेमाल किए जाने वाले सामान्य शब्दों की सूची नीचे दी गई है:

गतिविधि की रिपोर्ट

गतिविधि रिपोर्ट में, Google Workspace के किसी खास ऐप्लिकेशन या सेवा में की गई गतिविधियों की जानकारी मौजूद होती है. गतिविधि रिपोर्ट में तारीख, समय, उपयोगकर्ता, और गतिविधि का टाइप शामिल होता है. एपीआई के रेफ़रंस में, गतिविधि की रिपोर्ट और उनमें शामिल जानकारी की पूरी सूची होती है. यहां गतिविधि की कुछ रिपोर्ट के उदाहरण दिए गए हैं, जो ऐप्लिकेशन या सेवा के हिसाब से सूची में शामिल हैं:

  • एडमिन गतिविधि रिपोर्ट वे गतिविधियां दिखाती हैं जो एडमिन Admin console का इस्तेमाल करके करते हैं. उदाहरण के लिए, आपको यह जानकारी मिल सकती है कि एडमिन ने Admin console में, उपयोगकर्ता का नाम कितनी बार बदला है.
  • Google डिस्क गतिविधि रिपोर्ट में यह बताया जाता है कि आपके डोमेन के उपयोगकर्ता अपने डिस्क दस्तावेज़ों में कैसे बदलाव करते हैं और उन्हें कैसे देखते हैं. उदाहरण के लिए, आपके पास Drive पर किसी उपयोगकर्ता की गतिविधि की सूची देखने का विकल्प है.
  • लॉगिन गतिविधि की रिपोर्ट से यह जानकारी मिलती है कि आपके उपयोगकर्ताओं ने अपने खातों में कब लॉग इन किया और कब आउट किया. उदाहरण के लिए, किसी खास समयावधि में अपने डोमेन के सभी लॉगिन की रिपोर्ट देखी जा सकती है.
  • मोबाइल गतिविधि रिपोर्ट Google मोबाइल मैनेजमेंट से मैनेज किए जाने वाले मोबाइल डिवाइसों का इस्तेमाल करके गतिविधियां दिखाती हैं. उदाहरण के लिए, जब उपयोगकर्ता नया डिवाइस रजिस्टर करते हैं, तब आपको सूचना मिल सकती है.
  • OAuth टोकन गतिविधि रिपोर्ट उन इवेंट की सूची बनाएं जब आपके उपयोगकर्ताओं ने तीसरे पक्ष की वेबसाइटों और ऐप्लिकेशन को दिए गए या अनुमति टोकन को रद्द कर दिया हो. किसी उपयोगकर्ता के Google Workspace डेटा के ऐक्सेस से जुड़ी सभी तीसरे पक्ष की सूची पाने के लिए, Reports API का इस्तेमाल करें.
ट्रैक के इस्तेमाल से जुड़ी रिपोर्ट

इस्तेमाल की रिपोर्ट में, आपके डोमेन में Google Workspace के इवेंट के बारे में जानकारी मिलती है. उपयोगकर्ताओं के बारे में खास जानकारी मांगने के लिए, इस एपीआई का इस्तेमाल किया जा सकता है.

  • ग्राहक इस्तेमाल की रिपोर्ट में आपके खाते में ऐप्लिकेशन और सेवा से जुड़ी गतिविधियों की पूरी जानकारी होती है. इस्तेमाल से जुड़ी यह जानकारी, ऐप्लिकेशन के टाइप के हिसाब से व्यवस्थित होती है. इसमें उस ऐप्लिकेशन के लिए खास जानकारी होती है.
  • उपयोगकर्ता के इस्तेमाल की रिपोर्ट आपके खाते के उपयोगकर्ताओं की गतिविधियां दिखाती हैं. इन रिपोर्ट को उपयोग की खास जानकारी के लिए पसंद के मुताबिक और फ़िल्टर किया जा सकता है. यह इस्तेमाल करने की जानकारी, ऐप्लिकेशन के प्रकार के हिसाब से व्यवस्थित की जाती है और इसमें उस ऐप्लिकेशन के लिए खास जानकारी शामिल होती है.
  • इकाइयों के इस्तेमाल की रिपोर्ट में, Currents ऐप्लिकेशन में आपके खाते के उपयोगकर्ताओं ने जिन इकाइयों का इस्तेमाल किया है उनसे जुड़ी गतिविधियों की सूची होती है.
सूचनाएं
रिपोर्ट एपीआई से आपको इवेंट की जानकारी देखने की सुविधा मिलती है, जैसे कि संसाधनों में होने वाले बदलाव. जब कोई संसाधन देखा जाता है और वह संसाधन बदलता है, तो रिपोर्ट एपीआई आपको एक सूचना भेजता है. Reports API को सेट अप करने और इससे सूचनाएं पाने के बारे में ज़्यादा जानकारी के लिए, पुश नोटिफ़िकेशन पाना से जुड़ी गाइड देखें.

अगले चरण

  • Reports API के बारे में जानने और यह काम करने के लिए, क्विकस्टार्ट का इस्तेमाल करें. यह कोड, बाईं ओर मौजूद नेविगेशन बार में प्रोग्रामिंग भाषा के हिसाब से होता है. इस सेक्शन में, खाता सेट अप करने के बारे में सामान्य जानकारी भी देखी जा सकती है.

  • अनुमति वाले सेक्शन में, Google Workspace के ऐप्लिकेशन और सेवाओं से उपयोगकर्ता का डेटा पाने के लिए, OAuth 2.0 ऐक्सेस टोकन इस्तेमाल करने का तरीका बताया गया है.

  • किसी खास तरह के संसाधन या तरीके से जुड़ी जानकारी पाने के लिए, एपीआई का रेफ़रंस देखें.

  • ज़्यादा जानकारी के लिए, Admin SDK API से जुड़ी समस्या को ट्रैक करने वाला टूल, Google Workspace Developers ब्लॉग, और Google Workspace एडमिन सहायता केंद्र पर जाएं.