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

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