एडमिन गतिविधि की रिपोर्ट

एडमिन गतिविधि की रिपोर्ट में, आपके खाते के सभी एडमिन की Admin console गतिविधियों की जानकारी मिलती है. हर रिपोर्ट में, रिपोर्ट के लिए खास पैरामीटर के साथ-साथ रिपोर्ट के बुनियादी एंडपॉइंट अनुरोध का इस्तेमाल किया जाता है. जैसे, एडमिन का नाम या Admin console का कोई खास इवेंट. हर रिपोर्ट के लिए, ज़्यादा से ज़्यादा 180 दिनों का डेटा देखा जा सकता है.

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

एडमिन से जुड़ी सभी गतिविधियां फिर से पाना

किसी खाते के लिए की गई सभी एडमिन गतिविधियों की रिपोर्ट पाने के लिए, यहां दिया गया GET एचटीटीपी अनुरोध इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताया गया अनुमति टोकन शामिल करें. अनुरोध की क्वेरी स्ट्रिंग और जवाब की प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई रेफ़रंस देखें. पढ़ने में आसानी हो, इसके लिए यहां दिए गए उदाहरण को लाइन रिटर्न के साथ फ़ॉर्मैट किया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report

यहां दिए गए उदाहरण में, पिछले 180 दिनों के लिए आपके खाते की सभी एडमिन गतिविधियों की रिपोर्ट मिलती है. यह रिपोर्ट के लिए तय की गई ज़्यादा से ज़्यादा समयावधि है. साथ ही, maxResults क्वेरी स्ट्रिंग से पता चलता है कि इस रिपोर्ट में, हर रिपोर्ट पेज पर दो इवेंट शामिल हैं. एपीआई से मिले जवाब का उदाहरण देखने के लिए, JSON रिस्पॉन्स का उदाहरण देखें:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=2

यहां दिए गए उदाहरण में, पिछले 180 दिनों में ग्राहक की सभी एडमिन गतिविधियों की रिपोर्ट मिलती है. customerId से पता चलता है कि रिपोर्ट किस ग्राहक के लिए वापस लानी है.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?customerId=C03az79cb

एडमिन की सभी गतिविधियां फिर से पाएं

किसी एडमिन ने Admin console में कौन-कौनसी गतिविधियां की हैं, इसकी रिपोर्ट पाने के लिए, यहां दिया गया GET एचटीटीपी अनुरोध इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताया गया अनुमति टोकन शामिल करें. userKey, रिपोर्ट के एडमिन का प्राइमरी ईमेल पता है. अनुरोध की क्वेरी स्ट्रिंग और जवाब की प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई रेफ़रंस देखें. पढ़ने में आसानी हो, इसके लिए यहां दिए गए उदाहरण को लाइन रिटर्न के साथ फ़ॉर्मैट किया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report
&filters=event name parameter relational operator parameter value

यहां दिए गए उदाहरण में, john@example.com ने Admin console के ऐप्लिकेशन में जो भी बदलाव किए हैं उनकी रिपोर्ट मिलती है. साथ ही, जवाब को फ़िल्टर करके ऐसी सभी गतिविधियों को दिखाया जाता है जिनमें OLD_VALUE की वैल्यू ALLOW_CAMERA के बराबर है. एपीआई रिस्पॉन्स के उदाहरण के लिए, JSON रिस्पॉन्स का उदाहरण देखें. गतिविधियों के बारे में जानकारी पाने के लिए, एडमिन के इवेंट के नाम देखें:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA

इवेंट के नाम के हिसाब से सभी गतिविधियां फिर से पाना

किसी इवेंट के नाम से जुड़ी सभी गतिविधियों की रिपोर्ट पाने के लिए, यहां दिया गया GET एचटीटीपी अनुरोध इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताया गया अनुमति टोकन शामिल करें. eventName की जानकारी के लिए, एडमिन के लिए इवेंट के नामों की रेफ़रंस जानकारी देखें. अनुरोध की क्वेरी स्ट्रिंग और जवाब की प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई का रेफ़रंस देखें. पढ़ने में आसानी हो, इसके लिए यहां दिए गए उदाहरण को लाइन रिटर्न के साथ फ़ॉर्मैट किया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event

यहां दिए गए उदाहरण में, उपयोगकर्ता का उपनाम बदलने के लिए, Admin console के सभी इंस्टेंस की रिपोर्ट वापस पाई जाती है. एपीआई से मिले रिस्पॉन्स का उदाहरण देखने के लिए, JSON रिस्पॉन्स का उदाहरण देखें:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

इवेंट और एडमिन के हिसाब से सभी गतिविधियां वापस पाना

किसी खास एडमिन के किए गए, Admin console के सभी बदलावों की रिपोर्ट पाने के लिए, यहां दिया गया GET एचटीटीपी अनुरोध इस्तेमाल करें. साथ ही, अनुमति से जुड़े दस्तावेज़ में बताया गया अनुमति टोकन शामिल करें. userKey, रिपोर्ट के एडमिन का प्राइमरी ईमेल पता है. eventName की जानकारी के लिए, एडमिन के लिए इवेंट के नामों की रेफ़रंस जानकारी देखें. अनुरोध की क्वेरी स्ट्रिंग और जवाब की प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई का रेफ़रंस देखें. पढ़ने में आसानी हो, इसके लिए यहां दिए गए उदाहरण को लाइन रिटर्न के साथ फ़ॉर्मैट किया गया है:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event

यहां दिए गए उदाहरण में, किसी उपयोगकर्ता के उपनाम में Admin console से किए गए सभी बदलावों की रिपोर्ट मिलती है. ये बदलाव john@example.com ने किए थे. एपीआई से मिले जवाब का उदाहरण देखने के लिए, JSON रिस्पॉन्स का उदाहरण देखें:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

एडमिन की गतिविधि की रिपोर्ट के JSON रिस्पॉन्स का उदाहरण

अनुरोध पूरा होने पर, एचटीटीपी 200 स्टेटस कोड मिलता है. जवाब में स्टेटस कोड के साथ-साथ एक रिपोर्ट भी मिलती है. eventName के बारे में जानकारी पाने के लिए, एडमिन के लिए इवेंट के नामों की रेफ़रंस जानकारी देखें. अनुरोध के यूआरएल क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में ज़्यादा जानने के लिए, एपीआई रेफ़रंस देखें.

{
 "kind": "reports#auditActivities",
 "nextPageToken": "the next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2011-06-17T15:39:18.460Z",
    "uniqueQualifier": "report's unique ID",
    "applicationName": "admin",
    "customerId": "C03az79cb"
   },
   "actor": {
    "callerType": "USER",
    "email": "liz@example.com",
    "profileId": "user's unique Google Workspace profile ID",
    "key": "consumer key of requester in OAuth 2LO requests"
   },
   "ownerDomain": "example.com",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "GROUP_SETTINGS",
     "name": "CHANGE_GROUP_SETTING",
     "parameters": [
      {
        "name": "SETTING_NAME",
        "value": "WHO_CAN_JOIN",
        "intValue": "integer value of parameter",
        "boolValue": "boolean value of parameter"
      }
     ]
    }
   ]
  },
  {
   "kind": "audit#activity",
   "id": {
    "time": "2011-06-17T15:39:18.460Z",
    "uniqueQualifier": "reports unique ID",
    "applicationName": "admin",
    "customerId": "C03az79cb"
   },
   "actor": {
    "callerType": "USER",
    "email": "liz@example.com",
    "profileId": "user's unique Google Workspace profile ID",
    "key": "consumer key of requester in an OAuth 2LO request"
   },
   "ownerDomain": "example.com",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "GROUP_SETTINGS",
     "name": "CREATE_GROUP",
     "parameters": [
      {
        "name": "GROUP_EMAIL",
        "value": "helpdesk@example.com",
        "intValue": "",
        "boolValue": ""
       }
      ]
     }
    ]
   }
  ]
 }