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

उस होस्ट का इंटरनेट प्रोटोकॉल (आईपी) पता जहां इवेंट किया गया था. यह उस उपयोगकर्ता के आईपी पते का इस्तेमाल करके, किसी रिपोर्ट की खास जानकारी को फ़िल्टर करने का एक और तरीका है जिसकी गतिविधि की शिकायत की जा रही है. यह आईपी पता, उपयोगकर्ता की जगह की जानकारी दिखा भी सकता है और नहीं भी. उदाहरण के लिए, आईपी पता उपयोगकर्ता के किसी प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (VPN) पता हो सकता है. यह पैरामीटर 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 के इवेंट दिए गए हैं. 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 टेंप्लेट.

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

जेएसओएन के काेड में दिखाना 
{
  "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 ऐप्लिकेशन की गतिविधि रिपोर्ट, कैलेंडर गतिविधि के कई इवेंट की जानकारी दिखाती हैं.
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

'एंटरप्राइज़ ग्रुप' की गतिविधि रिपोर्ट में, एंटरप्राइज़ ग्रुप गतिविधि के अलग-अलग इवेंट के बारे में जानकारी दिखती है.
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 गतिविधि इवेंट के बारे में जानकारी दिखाती है.

Gemini पर की गई गतिविधि

गतिविधि संसाधन के लिए 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

एंट्री का ईटैग.
ownerDomain

string

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

string

कार्रवाई करने वाले उपयोगकर्ता का आईपी पता. यह Google Workspace में लॉग इन करते समय, उपयोगकर्ता का इंटरनेट प्रोटोकॉल (आईपी) पता होता है. यह पता, उपयोगकर्ता की जगह की जानकारी दे सकता है और नहीं भी. उदाहरण के लिए, आईपी पता उपयोगकर्ता के किसी प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (VPN) पता हो सकता है. यह एपीआई 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 या रोबोट खातों का आइडेंटिफ़ायर हो सकता है.