Reports API की खास जानकारी
संग्रह की मदद से व्यवस्थित रहें
अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.
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 Developers ब्लॉग, और Google Workspace के एडमिन सहायता केंद्र पर जाएं.
जब तक कुछ अलग से न बताया जाए, तब तक इस पेज की सामग्री को Creative Commons Attribution 4.0 License के तहत और कोड के नमूनों को Apache 2.0 License के तहत लाइसेंस मिला है. ज़्यादा जानकारी के लिए, Google Developers साइट नीतियां देखें. Oracle और/या इससे जुड़ी हुई कंपनियों का, Java एक रजिस्टर किया हुआ ट्रेडमार्क है.
आखिरी बार 2025-08-29 (UTC) को अपडेट किया गया.
[null,null,["आखिरी बार 2025-08-29 (UTC) को अपडेट किया गया."],[],[],null,["# Reports API Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]
