रिपोर्ट एपीआई: उपयोगकर्ताओं के इस्तेमाल की रिपोर्ट

उपयोगकर्ता के इस्तेमाल की रिपोर्ट में, आपके डोमेन के किसी खास उपयोगकर्ता के लिए 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"
    }
   ]
  }
 ]
}