उपयोगकर्ता के इस्तेमाल की रिपोर्ट, आपके डोमेन के किसी खास उपयोगकर्ता के लिए, Google Workspace सेवा के इस्तेमाल से जुड़ी जानकारी दिखाती है. इस्तेमाल करने की खास जानकारी के लिए, इन रिपोर्ट को अपनी पसंद के मुताबिक बनाया और फ़िल्टर किया जा सकता है. हर रिपोर्ट के लिए डिफ़ॉल्ट और ज़्यादा से ज़्यादा समयावधि, पिछले 450 दिनों की होती है.
इस उपयोगकर्ता के इस्तेमाल की रिपोर्ट का इस्तेमाल, आपके ग्राहक समझौते के मुताबिक सिर्फ़ कानूनी मकसद के लिए किया जा सकता है. ये रिपोर्ट, Google Workspace और Education पर लागू होती हैं.
उपयोगकर्ता के इस्तेमाल से जुड़ी सभी गतिविधियां फिर से पाएं
अपने खाते में सभी उपयोगकर्ता गतिविधियों की रिपोर्ट फिर से पाने के लिए, नीचे दिए गए GET एचटीटीपी अनुरोध का इस्तेमाल करें और ऑथराइज़ेशन दस्तावेज़ में बताया गया ऑथराइज़ेशन टोकन शामिल करें. पढ़ने में आसान होने के लिए, नीचे दिए गए उदाहरण को लाइन रिटर्न के साथ फ़ॉर्मैट किया गया है:
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
dates वैल्यू, इस्तेमाल की तारीख है और टाइमस्टैंप ISO 8601 फ़ॉर्मैट में है, yyyy-mm-dd. क्वेरी स्ट्रिंग पैरामीटर और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, एपीआई का रेफ़रंस देखें. उपयोगकर्ता के इस्तेमाल की रिपोर्ट के पैरामीटर के बारे में जानकारी पाने के लिए, उपयोगकर्ता के इस्तेमाल के पैरामीटर का रेफ़रंस देखें.
यहां दिए गए उदाहरण में, खाते की सभी उपयोगकर्ता गतिविधियों की रिपोर्ट दी गई है.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?maxResults=2
नीचे दिए गए उदाहरण में किसी खास ग्राहक खाते के लिए सभी उपयोगकर्ता गतिविधियों की रिपोर्ट दी गई है.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?customerId=C03az79cb
इस उदाहरण में खाते के उपयोगकर्ताओं के आखिरी लॉगिन टाइमस्टैंप की रिपोर्ट दी गई है. एपीआई से मिले रिस्पॉन्स के उदाहरण के लिए, JSON के रिस्पॉन्स का उदाहरण देखें.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&maxResults=2
इस उदाहरण में खाते के उपयोगकर्ताओं के आखिरी लॉगिन टाइमस्टैंप की रिपोर्ट दी गई है. इस रिपोर्ट में, उन उपयोगकर्ताओं को फ़िल्टर किया गया है जिन्होंने किसी खास समय के बाद लॉग इन किया था. एपीआई से मिले रिस्पॉन्स के उदाहरण के लिए, JSON के रिस्पॉन्स का उदाहरण देखें.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&filters=accounts:last_login_time >2010-10-28T10:26:35.000Z"
यहां दिए गए उदाहरण में, खाते के उपयोगकर्ताओं के आखिरी लॉगिन टाइमस्टैंप और निलंबित स्थिति की रिपोर्ट दी गई है. एपीआई से मिले रिस्पॉन्स के उदाहरण के लिए, JSON के रिस्पॉन्स का उदाहरण देखें.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time,accounts:is_disabled"
किसी उपयोगकर्ता की इस्तेमाल से जुड़ी गतिविधियां फिर से पाना
अपने खाते में किसी खास उपयोगकर्ता की गतिविधियों की रिपोर्ट पाने के लिए, यहां दिए गए GET एचटीटीपी अनुरोध का इस्तेमाल करें. साथ ही, ऑथराइज़ेशन दस्तावेज़ में बताया गया ऑथराइज़ेशन टोकन शामिल करें. पढ़ने में आसान होने के लिए, नीचे दिए गए उदाहरण को लाइन रिटर्न के साथ फ़ॉर्मैट किया गया है.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/userKey/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
userKey, रिपोर्ट में उपयोगकर्ता का मुख्य ईमेल पता या उपयोगकर्ता का यूनीक Google Workspace profileId हो सकता है. dates वैल्यू, इस्तेमाल की तारीख है और टाइमस्टैंप ISO 8601 फ़ॉर्मैट में है, yyyy-mm-dd. क्वेरी स्ट्रिंग पैरामीटर और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, एपीआई का रेफ़रंस देखें. उपयोगकर्ता के इस्तेमाल की रिपोर्ट के पैरामीटर के बारे में जानकारी पाने के लिए, उपयोगकर्ता के इस्तेमाल के पैरामीटर का रेफ़रंस देखें.
नीचे दिए गए उदाहरण में, john@example.com की इस्तेमाल की रिपोर्ट दी गई है.
https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03
इस्तेमाल की रिपोर्ट में JSON रिस्पॉन्स के बारे में जानकारी
पुष्टि होने के बाद, आपको एचटीटीपी 200 स्टेटस कोड दिखेगा. स्टेटस कोड के साथ, जवाब एक रिपोर्ट दिखाता है.
उपयोगकर्ता रिपोर्ट के लिए JSON का रिस्पॉन्स
{
"kind": "reports#usageReports",
"warnings": [
{
"code": warning machine-readable code,
"message": warning human-readable message,
"data": [
{
"key": key for key-value pair that gives detailed warning information,
"value": value for key-value pair giving detailed warning information
}
]
}
],
"nextPageToken": "N:NNN:NNN:N:C03az79cb",
"usageReports": [
{
"kind": "usageReport",
"date": "2013-03-03",
"entity": {
"type": "USER",
"customerId": "C03az79cb",
"userEmail": "liz@example.com",
"profileId": "user's unique Google Workspace ID"
},
"parameters": [
{
"name": "accounts:is_disabled",
"boolValue": false
},
{
"name": "accounts:disabled_reason",
"stringValue": "reason description"
},
{
"name": "accounts:first_name",
"stringValue": "Liz"
},
{
"name": "accounts:is_2sv_enforced",
"boolValue": false
},
{
"name": "accounts:is_2sv_enrolled",
"boolValue": false
},
{
"name": "accounts:last_name",
"stringValue": "Smith"
},
{
"name": "accounts:creation_time",
"datetimeValue": "2010-10-28T10:26:35.000Z"
},
{
"name": "accounts:last_login_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
},
{
"name": "accounts:last_sso_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
}
]
}
]
}