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

string

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

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 के इवेंट. 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

रिपोर्ट में दिखाई गई समयसीमा की शुरुआत सेट करता है. तारीख, आरएफ़सी 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 ऑब्जेक्ट की activities.list.

events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

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

id

object

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

id.time

string

गतिविधि के होने का समय. यह यूनिक्स के टाइमस्टैंप में सेकंड में है.

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 या रोबोट खातों का आइडेंटिफ़ायर हो सकता है.