Method: activities.list

किसी खास ग्राहक के खाते और ऐप्लिकेशन, जैसे कि Admin console ऐप्लिकेशन या Google Drive ऐप्लिकेशन के लिए गतिविधियों की सूची लाता है. ज़्यादा जानकारी के लिए, एडमिन और Google Drive की गतिविधि रिपोर्ट की गाइड देखें. गतिविधि रिपोर्ट के पैरामीटर के बारे में ज़्यादा जानकारी के लिए, गतिविधि पैरामीटर से जुड़ी रेफ़रंस गाइड देखें.

एचटीटीपी अनुरोध

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
userKey or all

string

यह उस प्रोफ़ाइल आईडी या उपयोगकर्ता के ईमेल को दिखाता है जिसके लिए डेटा फ़िल्टर करना है. पूरी जानकारी के लिए all या उपयोगकर्ता के खास Google Workspace प्रोफ़ाइल आईडी या मुख्य ईमेल पते के लिए userKey लिखा जा सकता है. हटाया गया उपयोगकर्ता नहीं होना चाहिए. मिटाए गए उपयोगकर्ता के लिए, showDeleted=true के साथ डायरेक्ट्री एपीआई में users.list को कॉल करें. इसके बाद, लौटाए गए ID को userKey के तौर पर इस्तेमाल करें.
applicationName

enum (ApplicationName)

ऐप्लिकेशन का नाम जिसके लिए इवेंट फिर से पाने हैं.

क्वेरी पैरामीटर

पैरामीटर
actorIpAddress

string

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

string

उस ग्राहक का यूनीक आईडी जिसके लिए डेटा पाना है.
endTime

string

रिपोर्ट में दिखाई गई समय सीमा का अंत सेट करता है. तारीख RFC 3339 फ़ॉर्मैट में है, जैसे कि 2010-10-28T10:26:35.000Z. डिफ़ॉल्ट वैल्यू, एपीआई अनुरोध का अनुमानित समय होता है. एपीआई रिपोर्ट में समय के तीन बुनियादी कॉन्सेप्ट होते हैं:

  • रिपोर्ट के लिए एपीआई का अनुरोध करने की तारीख: जब एपीआई ने रिपोर्ट बनाई और उसे वापस लाया.
  • रिपोर्ट के शुरू होने का समय: रिपोर्ट में दिखने वाली समयावधि की शुरुआत. startTime, endTime (अगर बताई गई हो) और अनुरोध किए जाने के मौजूदा समय से पहले होना चाहिए. ऐसा न होने पर, एपीआई गड़बड़ी दिखाता है.
  • रिपोर्ट के खत्म होने का समय: रिपोर्ट में दिखाई गई समयावधि खत्म होने का समय. उदाहरण के लिए, किसी रिपोर्ट में खास जानकारी वाले इवेंट की समयावधि, अप्रैल से शुरू हो सकती है और मई में खत्म हो सकती है. अगस्त में रिपोर्ट का अनुरोध किया जा सकता है.
अगर endTime के बारे में जानकारी नहीं दी गई है, तो रिपोर्ट, startTime से मौजूदा समय तक की सभी गतिविधियां दिखाती है. इसके अलावा, अगर startTime पिछले 180 दिनों से ज़्यादा का है, तो हाल के 180 दिनों की गतिविधियां दिखाता है.
eventName

string

उस इवेंट का नाम जिसके लिए एपीआई की मदद से क्वेरी की जा रही है. हर eventName, Google Workspace की किसी ऐसी सेवा या सुविधा से जुड़ा होता है जिसे एपीआई, अलग-अलग तरह के इवेंट के हिसाब से व्यवस्थित करता है. Admin console ऐप्लिकेशन की रिपोर्ट में Google कैलेंडर इवेंट एक उदाहरण हैं. Calendar सेटिंग type स्ट्रक्चर में, Calendar eventName से जुड़ी वे सभी गतिविधियां शामिल हैं जिन्हें एपीआई ने रिपोर्ट किया है. जब कोई एडमिन Calendar की सेटिंग में बदलाव करता है, तो एपीआई इस गतिविधि को Calendar की सेटिंग type और eventName पैरामीटर में रिपोर्ट करता है. eventName क्वेरी स्ट्रिंग और पैरामीटर के बारे में ज़्यादा जानकारी के लिए, ऊपर applicationName में अलग-अलग ऐप्लिकेशन के लिए इवेंट के नामों की सूची देखें.
filters

string

filters क्वेरी स्ट्रिंग, कॉमा लगाकर अलग की गई एक सूची है. इसमें ऐसे इवेंट पैरामीटर होते हैं जिनमें रिलेशनल ऑपरेटर इस्तेमाल करते हैं. इवेंट पैरामीटर {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},... फ़ॉर्म में होते हैं

ये इवेंट पैरामीटर, किसी खास eventName से जुड़े होते हैं. अगर अनुरोध का पैरामीटर eventName से नहीं जुड़ा है, तो खाली रिपोर्ट दिखती है. हर ऐप्लिकेशन के लिए उपलब्ध eventName फ़ील्ड और उनसे जुड़े पैरामीटर के बारे में ज़्यादा जानकारी के लिए, ApplicationName टेबल पर जाएं. इसके बाद, अपनी पसंद के ऐप्लिकेशन के लिए, अपेंडिक्स में मौजूद गतिविधि इवेंट पेज पर क्लिक करें.

Drive पर की जाने वाली इन गतिविधियों के इन उदाहरणों में, दिखाई गई सूची में ऐसे सभी edit इवेंट शामिल हैं जिनमें doc_id पैरामीटर की वैल्यू, रिलेशनल ऑपरेटर की तय की गई शर्तों से मेल खाती है. पहले उदाहरण में, अनुरोध, बदलाव किए गए सभी दस्तावेज़ों को doc_id वैल्यू के साथ 12345 के बराबर दिखाता है. दूसरे उदाहरण में, रिपोर्ट ऐसे बदलाव किए गए दस्तावेज़ दिखाती है जिनमें doc_id वैल्यू 98765 के बराबर नहीं होती. <> ऑपरेटर को अनुरोध की क्वेरी स्ट्रिंग (%3C%3E) में यूआरएल-एनकोड किया गया है:

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

filters क्वेरी में, इन रिलेशनल ऑपरेटर का इस्तेमाल किया जा सकता है:

  • ==—'इसके बराबर है'.
  • <>—'इसके बराबर नहीं'. यूआरएल के कोड में बदला गया (%3C%3E) होना चाहिए.
  • <—'इससे कम'. यूआरएल के कोड में बदला गया (%3C) होना चाहिए.
  • <=—'इससे कम या इसके बराबर'. यूआरएल कोड में बदला गया (%3C=) होना चाहिए.
  • >—'इससे ज़्यादा'. यूआरएल के कोड में बदला गया (%3E) होना चाहिए.
  • >=—'इससे ज़्यादा या इसके बराबर'. यूआरएल कोड में बदला गया (%3E=) होना चाहिए.

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

integer

इससे यह तय होता है कि जवाब वाले हर पेज पर गतिविधि के कितने रिकॉर्ड दिखाए जाते हैं. उदाहरण के लिए, अगर अनुरोध में maxResults=1 सेट की गई है और रिपोर्ट में दो गतिविधियां हैं, तो इसका मतलब है कि रिपोर्ट में दो पेज होंगे. रिस्पॉन्स की nextPageToken प्रॉपर्टी में, दूसरे पेज का टोकन होता है. अनुरोध में maxResults क्वेरी स्ट्रिंग को शामिल करना ज़रूरी नहीं है. डिफ़ॉल्ट वैल्यू 1000 है.
orgUnitID

string

संगठन की उस इकाई का आईडी जिसकी रिपोर्ट करनी है. गतिविधि के रिकॉर्ड सिर्फ़ उन उपयोगकर्ताओं को दिखाए जाएंगे जो खास संगठन की इकाई से जुड़े हैं.

pageToken

string

अगले पेज के बारे में बताने के लिए टोकन. कई पेजों वाली रिपोर्ट के जवाब में nextPageToken प्रॉपर्टी मिली है. रिपोर्ट का अगला पेज पाने के लिए अपने फ़ॉलो-ऑन अनुरोध में, pageToken क्वेरी स्ट्रिंग में nextPageToken वैल्यू डालें.
startTime

string

रिपोर्ट में दिखाए गए समय की सीमा का शुरुआती सेट करता है. तारीख RFC 3339 फ़ॉर्मैट में है, जैसे कि 2010-10-28T10:26:35.000Z. रिपोर्ट में, startTime से endTime तक की सभी गतिविधियां दिखती हैं. startTime, endTime (अगर बताई गई हो) और अनुरोध किए जाने के मौजूदा समय से पहले होना चाहिए. ऐसा न होने पर, एपीआई गड़बड़ी दिखाता है.
groupIdFilter

string

कॉमा लगाकर अलग किए गए ऐसे ग्रुप आईडी (अस्पष्ट) जिन पर उपयोगकर्ता गतिविधियां फ़िल्टर की जाती हैं. इसका मतलब है कि जवाब में सिर्फ़ उन उपयोगकर्ताओं की गतिविधियां शामिल की जाएंगी जो यहां बताए गए कम से कम किसी एक ग्रुप आईडी का हिस्सा हैं. फ़ॉर्मैट: "id:abc123,id:xyz456"

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

गतिविधियों के संग्रह के लिए JSON टेंप्लेट.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
फ़ील्ड
kind

string

एपीआई रिसॉर्स का टाइप. गतिविधि की रिपोर्ट की वैल्यू reports#activities है.
etag

string

संसाधन का ETag.
items[]

object (Activity)

जवाब में हर गतिविधि का डेटा रिकॉर्ड किया जाता है.
nextPageToken

string

रिपोर्ट के अगले पेज पर अगला पेज पाने के लिए टोकन. nextPageToken वैल्यू का इस्तेमाल, अनुरोध की pageToken क्वेरी स्ट्रिंग में किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.

ApplicationName

Enums
access_transparency

Google Workspace की ऐक्सेस ट्रांसपेरंसी (पारदर्शिता) गतिविधि की रिपोर्ट में, ऐक्सेस ट्रांसपेरंसी (पारदर्शिता) गतिविधि से जुड़े इवेंट के अलग-अलग टाइप की जानकारी दिखती है.
admin

Admin console ऐप्लिकेशन की गतिविधि रिपोर्ट, एडमिन गतिविधि इवेंट के अलग-अलग टाइप के बारे में खाते की जानकारी देती है.
calendar

Google Calendar ऐप्लिकेशन की गतिविधि रिपोर्ट, Calendar में की गई गतिविधि के कई इवेंट के बारे में जानकारी दिखाती हैं.
chat Chat में की गई गतिविधि की रिपोर्ट में, Chat पर की गई गतिविधि के इवेंट की जानकारी दिखती है.
drive

Google Drive ऐप्लिकेशन की गतिविधि रिपोर्ट, Google Drive पर की गई कई गतिविधि के इवेंट की जानकारी दिखाती है. Drive पर की गई गतिविधि की रिपोर्ट सिर्फ़ Google Workspace Business और Enterprise के ग्राहकों के लिए उपलब्ध है.
gcp Google Cloud Platform ऐप्लिकेशन की गतिविधि रिपोर्ट, GCP गतिविधि के इवेंट के बारे में जानकारी दिखाती है.
gplus Google+ ऐप्लिकेशन की गतिविधि रिपोर्ट, Google+ की कई गतिविधियों की जानकारी दिखाती है.
groups

Google Groups ऐप्लिकेशन की गतिविधि की रिपोर्ट, Groups की अलग-अलग गतिविधि के इवेंट के बारे में जानकारी देती है.
groups_enterprise

Enterprise Groups गतिविधि की रिपोर्ट में, एंटरप्राइज़ ग्रुप की गतिविधि के इवेंट के बारे में जानकारी मिलती है.
jamboard Jamboard गतिविधि रिपोर्ट में कई Jamboard गतिविधि इवेंट की जानकारी दिखाई जाती है.
login

लॉगिन ऐप्लिकेशन की गतिविधि रिपोर्ट, लॉगिन गतिविधि इवेंट के अलग-अलग टाइप के बारे में खाते की जानकारी देती हैं.
meet Meet ऑडिट गतिविधि की रिपोर्ट, Meet में ऑडिट गतिविधि के इवेंट के अलग-अलग टाइप के बारे में जानकारी दिखाती है.
mobile डिवाइस ऑडिट गतिविधि रिपोर्ट अलग-अलग प्रकार के डिवाइस ऑडिट गतिविधि इवेंट के बारे में जानकारी देती है.
rules

नियमों की गतिविधि की रिपोर्ट, नियम से जुड़ी गतिविधि के इवेंट के अलग-अलग टाइप के बारे में जानकारी दिखाती है.
saml

एसएएमएल गतिविधि की रिपोर्ट अलग-अलग तरह के एसएएमएल गतिविधि इवेंट के बारे में जानकारी देती है.
token

टोकन ऐप्लिकेशन की गतिविधि रिपोर्ट, टोकन की गतिविधि के अलग-अलग इवेंट के बारे में खाते की जानकारी दिखाती है.
user_accounts

उपयोगकर्ता खाता ऐप्लिकेशन की गतिविधि रिपोर्ट, अलग-अलग तरह के उपयोगकर्ता खाते गतिविधि इवेंट के बारे में खाते की जानकारी दिखाती है.
context_aware_access

कॉन्टेक्स्ट अवेयर ऐक्सेस गतिविधि की रिपोर्ट में उपयोगकर्ताओं के कॉन्टेक्स्ट अवेयर ऐक्सेस के नियमों की वजह से ऐक्सेस अस्वीकार किए गए इवेंट.
chrome

Chrome गतिविधि की रिपोर्ट से, Chrome ब्राउज़र और Chrome OS इवेंट के बारे में जानकारी मिलती है.
data_studio Data Studio की गतिविधि रिपोर्ट से, कई तरह के Data Studio के गतिविधि इवेंट की जानकारी मिलती है.
keep Keep ऐप्लिकेशन की गतिविधि रिपोर्ट, Google Keep की कई गतिविधि इवेंट के बारे में जानकारी दिखाती है. Keep गतिविधि की रिपोर्ट, सिर्फ़ Google Workspace Business और Enterprise के ग्राहकों के लिए उपलब्ध है.
vault Vault की गतिविधि रिपोर्ट से, अलग-अलग तरह की Vault की गतिविधि के इवेंट की जानकारी मिलती है.

गतिविधि

गतिविधि वाले संसाधन के लिए JSON टेंप्लेट.

JSON के काेड में दिखाना 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}
फ़ील्ड
kind

string

एपीआई रिसॉर्स का टाइप. गतिविधि की रिपोर्ट की वैल्यू audit#activity है.
etag

string

एंट्री का ETag.
ownerDomain

string

इस डोमेन पर रिपोर्ट के इवेंट का असर पड़ता है. उदाहरण के लिए, Admin console का डोमेन या Drive ऐप्लिकेशन के दस्तावेज़ के मालिक का नाम.
ipAddress

string

कार्रवाई करने वाले उपयोगकर्ता का आईपी पता. यह Google Workspace में लॉग इन करते समय, उपयोगकर्ता का इंटरनेट प्रोटोकॉल (आईपी) पता होता है. इसमें उपयोगकर्ता की जगह की जानकारी हो भी सकती है और नहीं भी. उदाहरण के लिए, आईपी पता, उपयोगकर्ता के प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (वीपीएन) पता हो सकता है. यह एपीआई IPv4 और IPv6 के साथ काम करता है.
events[]

object

रिपोर्ट में गतिविधि से जुड़े इवेंट.
events[].type

string

इवेंट का टाइप. Google Workspace की उस सेवा या सुविधा की पहचान type प्रॉपर्टी में की जाती है जिसे एडमिन बदल देता है. यह सेवा या सुविधा, eventName प्रॉपर्टी का इस्तेमाल करके किसी इवेंट की पहचान करने में मदद करती है. एपीआई की type कैटगरी की पूरी सूची देखने के लिए, ऊपर applicationName में मौजूद अलग-अलग ऐप्लिकेशन के इवेंट के नामों की सूची देखें.
events[].name

string

इवेंट का नाम. गतिविधि का यह नाम एपीआई की मदद से रिपोर्ट किया जाता है. साथ ही, हर eventName किसी खास Google Workspace सेवा या सुविधा से जुड़ा होता है, जिसे एपीआई अलग-अलग इवेंट के हिसाब से व्यवस्थित करता है.
आम तौर पर eventName अनुरोध पैरामीटर के लिए:

  • अगर eventName नहीं दिया गया है, तो रिपोर्ट में eventName के सभी संभावित इंस्टेंस दिखाए जाते हैं.
  • eventName का अनुरोध करने पर, एपीआई का रिस्पॉन्स, उन सभी गतिविधियों की जानकारी दिखाता है जिनमें वह eventName शामिल है.

eventName प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, ऊपर applicationName में दिए गए अलग-अलग ऐप्लिकेशन के इवेंट के नामों की सूची देखें.
events[].parameters[]

object

अलग-अलग ऐप्लिकेशन के लिए पैरामीटर वैल्यू पेयर. eventName पैरामीटर के बारे में ज़्यादा जानकारी के लिए, ऊपर applicationName में मौजूद अलग-अलग ऐप्लिकेशन के इवेंट के नामों की सूची देखें.
events[].parameters[].messageValue

object

इस पैरामीटर से जुड़े नेस्ट किए गए पैरामीटर के मान के जोड़े. किसी पैरामीटर के लिए कॉम्प्लेक्स वैल्यू टाइप को पैरामीटर वैल्यू की सूची के तौर पर दिखाया जाता है. उदाहरण के लिए, पता पैरामीटर की वैल्यू [{parameter: [{name: city, value: abc}]}] हो सकती है
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

पैरामीटर के मान
events[].parameters[].name

string

पैरामीटर का नाम.
events[].parameters[].value

string

पैरामीटर की स्ट्रिंग वैल्यू.
events[].parameters[].multiValue[]

string

पैरामीटर की स्ट्रिंग वैल्यू.
events[].parameters[].intValue

string (int64 format)

पैरामीटर की पूर्णांक वैल्यू.
events[].parameters[].multiIntValue[]

string (int64 format)

पैरामीटर की पूर्णांक वैल्यू.
events[].parameters[].boolValue

boolean

पैरामीटर की बूलियन वैल्यू.
events[].parameters[].multiMessageValue[]

object

messageValue ऑब्जेक्ट की activity.list.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

पैरामीटर के मान
id

object

हर गतिविधि के रिकॉर्ड के लिए यूनीक आइडेंटिफ़ायर.
id.time

string

गतिविधि के होने का समय. यह सेकंड में UNIX epoch टाइम है.
id.uniqueQualifier

string (int64 format)

यूनीक क्वालीफ़ायर, अगर कई इवेंट का एक ही समय है.
id.applicationName

string

इवेंट से जुड़े ऐप्लिकेशन का नाम. संभावित वैल्यू के लिए, applicationName में ऊपर दिए गए ऐप्लिकेशन की सूची देखें.
id.customerId

string

Google Workspace खाते के लिए यूनीक आइडेंटिफ़ायर.
actor

object

कार्रवाई करता हुआ उपयोगकर्ता.
actor.profileId

string

उपयोगकर्ता का यूनीक Google Workspace प्रोफ़ाइल आईडी. अगर उपयोगकर्ता, Google Workspace का उपयोगकर्ता नहीं है या प्लेसहोल्डर आईडी के तौर पर काम करने वाला नंबर 105250506097979753968 हो सकता है, तो यह वैल्यू मौजूद नहीं होगी.
actor.email

string

कलाकार का मुख्य ईमेल पता. अगर कलाकार से जुड़ा कोई ईमेल पता न हो, तो हो सकता है कि यह ईमेल न दिखे.
actor.callerType

string

कलाकार किस तरह का है.
actor.key

string

यह सिर्फ़ तब मौजूद होता है, जब callerType की वैल्यू KEY होती है. यह OAuth 2LO एपीआई अनुरोधों के लिए अनुरोध करने वाले व्यक्ति का consumer_key या रोबोट खातों का आइडेंटिफ़ायर हो सकता है.