- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- ApplicationName
- गतिविधि
- ResourceDetails
- AppliedLabel
- FieldValue
- TextListValue
- SelectionValue
- SelectionListValue
- UserValue
- UserListValue
- तारीख
- वजह
- इसे आज़माएं!
किसी ग्राहक के खाते और ऐप्लिकेशन की गतिविधियों की सूची दिखाता है. जैसे, 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 |
उस प्रोफ़ाइल आईडी या उपयोगकर्ता के ईमेल पते की जानकारी देता है जिसके लिए डेटा फ़िल्टर करना है. यह वैल्यू, पूरी जानकारी के लिए |
applicationName |
उस ऐप्लिकेशन का नाम जिसके लिए इवेंट वापस लाने हैं. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
actorIpAddress |
उस होस्ट का इंटरनेट प्रोटोकॉल (आईपी) पता जहां इवेंट हुआ था. यह रिपोर्ट की खास जानकारी को फ़िल्टर करने का एक और तरीका है. इसके लिए, उस उपयोगकर्ता के आईपी पते का इस्तेमाल किया जाता है जिसकी गतिविधि की शिकायत की जा रही है. यह आईपी पता, उपयोगकर्ता की जगह की जानकारी दिखा सकता है या नहीं. उदाहरण के लिए, आईपी पता, उपयोगकर्ता के प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (वीपीएन) का पता हो सकता है. यह पैरामीटर, IPv4 और IPv6, दोनों आईपी पते के वर्शन के साथ काम करता है. |
customerId |
उस ग्राहक का यूनीक आईडी जिसका डेटा आपको चाहिए. |
endTime |
रिपोर्ट में दिखाई गई समयसीमा के खत्म होने की तारीख सेट करता है. तारीख, आरएफ़सी 3339 फ़ॉर्मैट में होनी चाहिए. उदाहरण के लिए, 2010-10-28T10:26:35.000Z. डिफ़ॉल्ट वैल्यू, एपीआई अनुरोध का अनुमानित समय होता है. किसी एपीआई रिपोर्ट में, समय के तीन बुनियादी कॉन्सेप्ट होते हैं:
endTime की जानकारी नहीं दी गई है, तो रिपोर्ट में startTime से लेकर मौजूदा समय तक की सभी गतिविधियां दिखेंगी. अगर startTime की तारीख 180 दिनों से पहले की है, तो रिपोर्ट में हाल के 180 दिनों की गतिविधियां दिखेंगी.
|
eventName |
उस इवेंट का नाम जिसकी जानकारी के लिए एपीआई क्वेरी कर रहा है. हर |
filters |
ये इवेंट पैरामीटर, किसी खास Drive गतिविधि के इन उदाहरणों में, दिखाई गई सूची में वे सभी
ध्यान दें: एपीआई, एक ही पैरामीटर की कई वैल्यू स्वीकार नहीं करता. अगर एपीआई अनुरोध में किसी पैरामीटर को एक से ज़्यादा बार दिया जाता है, तो एपीआई सिर्फ़ उस पैरामीटर की आखिरी वैल्यू स्वीकार करता है. इसके अलावा, अगर एपीआई अनुरोध में कोई अमान्य पैरामीटर दिया जाता है, तो एपीआई उस पैरामीटर को अनदेखा कर देता है और बाकी मान्य पैरामीटर के हिसाब से जवाब दिखाता है. अगर किसी पैरामीटर का अनुरोध नहीं किया जाता है, तो सभी पैरामीटर दिखाए जाते हैं. |
maxResults |
इससे यह तय होता है कि हर जवाब वाले पेज पर गतिविधि के कितने रिकॉर्ड दिखाए जाएं. उदाहरण के लिए, अगर अनुरोध |
orgUnitID |
जिस संगठन की इकाई के लिए रिपोर्ट करनी है उसका आईडी. गतिविधि के रिकॉर्ड सिर्फ़ उन उपयोगकर्ताओं के लिए दिखाए जाएंगे जो चुनी गई संगठन की इकाई से जुड़े हैं. |
pageToken |
अगले पेज की जानकारी देने वाला टोकन. एक से ज़्यादा पेजों वाली रिपोर्ट के रिस्पॉन्स में |
startTime |
रिपोर्ट में दिखाई गई समयसीमा की शुरुआत सेट करता है. तारीख, आरएफ़सी 3339 फ़ॉर्मैट में होनी चाहिए. उदाहरण के लिए, 2010-10-28T10:26:35.000Z. रिपोर्ट में |
groupIdFilter |
कॉमा से अलग किए गए ग्रुप आईडी (धुंधला किए गए), जिन पर उपयोगकर्ता की गतिविधियों को फ़िल्टर किया जाता है. इसका मतलब है कि जवाब में सिर्फ़ उन उपयोगकर्ताओं की गतिविधियां शामिल होंगी जो यहां बताए गए कम से कम एक ग्रुप आईडी का हिस्सा हैं. फ़ॉर्मैट: "id:abc123,id:xyz456" लेख पढ़ें |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
गतिविधियों के कलेक्शन के लिए JSON टेंप्लेट.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
फ़ील्ड | |
---|---|
kind |
एपीआई रिसॉर्स का टाइप. गतिविधि रिपोर्ट के लिए, वैल्यू |
etag |
संसाधन का ETag. |
items[] |
रिस्पॉन्स में हर गतिविधि का रिकॉर्ड. |
nextPageToken |
रिपोर्ट के अगले पेज को फ़ॉलो करने के लिए टोकन. |
अनुमति के दायरे
नीचे दिए गए 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 ग्रुप की गतिविधि की रिपोर्ट में, 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_for_workspace |
Gemini for Workspace ऐप्लिकेशन की गतिविधि रिपोर्ट में, Gemini गतिविधि के अलग-अलग तरह के इवेंट की जानकारी मिलती है. |
गतिविधि
गतिविधि संसाधन के लिए JSON टेंप्लेट.
JSON के काेड में दिखाना |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
फ़ील्ड | |
---|---|
kind |
एपीआई रिसॉर्स का टाइप. गतिविधि रिपोर्ट के लिए, वैल्यू |
etag |
एंट्री का ETag. |
ownerDomain |
यह वह डोमेन है जिस पर रिपोर्ट के इवेंट का असर पड़ा है. उदाहरण के लिए, Admin console का डोमेन या Drive ऐप्लिकेशन के दस्तावेज़ का मालिक. |
ipAddress |
कार्रवाई करने वाले उपयोगकर्ता का आईपी पता. यह Google Workspace में लॉग इन करते समय, उपयोगकर्ता का इंटरनेट प्रोटोकॉल (आईपी) पता होता है. यह उपयोगकर्ता की जगह की जानकारी दिखा सकता है या नहीं. उदाहरण के लिए, आईपी पता, उपयोगकर्ता के प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (वीपीएन) का पता हो सकता है. यह एपीआई, IPv4 और IPv6 के साथ काम करता है. |
events[] |
रिपोर्ट में गतिविधि इवेंट. |
events[].type |
इवेंट का टाइप. Google Workspace की जिस सेवा या सुविधा में एडमिन बदलाव करता है उसकी पहचान |
events[].name |
इवेंट का नाम. यह एपीआई की रिपोर्ट की गई गतिविधि का खास नाम है. साथ ही, हर
eventName प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, applicationName में ऊपर दिए गए अलग-अलग ऐप्लिकेशन के लिए इवेंट के नामों की सूची देखें.
|
events[].parameters[] |
अलग-अलग ऐप्लिकेशन के लिए पैरामीटर वैल्यू के पेयर. |
events[].parameters[].messageValue |
इस पैरामीटर से जुड़े नेस्ट किए गए पैरामीटर वैल्यू पेयर. किसी पैरामीटर के लिए कॉम्प्लेक्स वैल्यू टाइप, पैरामीटर वैल्यू की सूची के तौर पर दिखाया जाता है. उदाहरण के लिए, पते के पैरामीटर की वैल्यू |
events[].parameters[].messageValue.parameter[] |
पैरामीटर वैल्यू |
events[].parameters[].name |
पैरामीटर का नाम. |
events[].parameters[].value |
पैरामीटर की स्ट्रिंग वैल्यू. |
events[].parameters[].multiValue[] |
पैरामीटर की स्ट्रिंग वैल्यू. |
events[].parameters[].intValue |
पैरामीटर की इंटीजर वैल्यू. |
events[].parameters[].multiIntValue[] |
पैरामीटर की इंटीजर वैल्यू. |
events[].parameters[].boolValue |
पैरामीटर की बूलियन वैल्यू. |
events[].parameters[].multiMessageValue[] |
|
events[].parameters[].multiMessageValue[].parameter[] |
पैरामीटर वैल्यू |
events[].resourceIds[] |
इवेंट से जुड़े रिसॉर्स आईडी. |
id |
हर गतिविधि रिकॉर्ड के लिए यूनीक आइडेंटिफ़ायर. |
id.time |
गतिविधि होने का समय. यह यूनिक्स के टाइमस्टैंप में सेकंड में है. |
id.uniqueQualifier |
अगर एक से ज़्यादा इवेंट एक ही समय पर होते हैं, तो यूनीक क्वालिफ़ायर. |
id.applicationName |
उस ऐप्लिकेशन का नाम जिससे इवेंट जुड़ा है. संभावित वैल्यू के लिए, ऊपर |
id.customerId |
Google Workspace खाते का यूनीक आइडेंटिफ़ायर. |
actor |
कार्रवाई करने वाला उपयोगकर्ता. |
actor.profileId |
कलाकार का Google Workspace प्रोफ़ाइल आईडी. अगर ऐक्टर, Google Workspace का उपयोगकर्ता नहीं है, तो हो सकता है कि यह वैल्यू मौजूद न हो. इसके अलावा, यह वैल्यू 105250506097979753968 हो सकती है, जो प्लेसहोल्डर आईडी के तौर पर काम करती है. |
actor.email |
कलाकार का मुख्य ईमेल पता. अगर कलाकार का कोई ईमेल पता नहीं है, तो यह एट्रिब्यूट मौजूद नहीं हो सकता. |
actor.callerType |
ऐक्टर का टाइप. |
actor.key |
यह सिर्फ़ तब मौजूद होता है, जब |
actor.applicationInfo |
उस ऐप्लिकेशन की जानकारी जो गतिविधि के लिए ऐक्टर था. |
actor.applicationInfo.oauthClientId |
तीसरे पक्ष के उस ऐप्लिकेशन का OAuth क्लाइंट आईडी जिसका इस्तेमाल कार्रवाई करने के लिए किया गया है. |
actor.applicationInfo.applicationName |
कार्रवाई करने के लिए इस्तेमाल किए गए ऐप्लिकेशन का नाम. |
actor.applicationInfo.impersonation |
क्या ऐप्लिकेशन किसी उपयोगकर्ता के नाम पर काम कर रहा था. |
resourceDetails[] |
उस संसाधन की जानकारी जिस पर कार्रवाई की गई. |
ResourceDetails
उस संसाधन की जानकारी जिस पर कार्रवाई की गई.
JSON के काेड में दिखाना |
---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
फ़ील्ड | |
---|---|
id |
रिसॉर्स का आइडेंटिफ़ायर. |
title |
संसाधन का टाइटल. उदाहरण के लिए, Drive दस्तावेज़ के लिए, यह दस्तावेज़ का शीर्षक होगा. ईमेल के मामले में, यह विषय होगा. |
type |
संसाधन का टाइप - दस्तावेज़, ईमेल, चैट मैसेज |
appliedLabels[] |
गतिविधियां.संसाधन पर लागू किए गए लेबल की सूची |
relation |
इवेंट के साथ संसाधन का संबंध तय करता है |
AppliedLabel
संसाधन पर लागू किए गए लेबल की जानकारी.
JSON के काेड में दिखाना |
---|
{ "id": string, "title": string, "fieldValues": [ { object ( |
फ़ील्ड | |
---|---|
id |
लेबल का आइडेंटिफ़ायर - सिर्फ़ लेबल आईडी, OnePlatform संसाधन का पूरा नाम नहीं. |
title |
लेबल का टाइटल |
fieldValues[] |
activities.list उन फ़ील्ड की सूची है जो लेबल का हिस्सा हैं और जिन्हें उपयोगकर्ता ने सेट किया है. अगर लेबल में कोई ऐसा फ़ील्ड है जिसे उपयोगकर्ता ने सेट नहीं किया है, तो वह इस सूची में मौजूद नहीं होगा. |
reason |
संसाधन पर लेबल लागू करने की वजह. |
FieldValue
किसी खास लेबल के लिए, उपयोगकर्ता की ओर से सेट की गई फ़ील्ड वैल्यू की जानकारी.
JSON के काेड में दिखाना |
---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
फ़ील्ड | |
---|---|
id |
फ़ील्ड का आइडेंटिफ़ायर |
displayName |
फ़ील्ड का डिसप्ले नेम |
type |
फ़ील्ड का टाइप |
reason |
लेबल पर फ़ील्ड लागू करने की वजह. |
यूनियन फ़ील्ड value . फ़ील्ड में सेव की गई वैल्यू को स्टोर करता है value इनमें से सिर्फ़ एक हो सकता है: |
|
unsetValue |
अगर फ़ील्ड सेट नहीं है, तो यह सही होगा. |
longTextValue |
लंबी टेक्स्ट वैल्यू सेट करना. |
textValue |
टेक्स्ट वैल्यू सेट करना. |
textListValue |
टेक्स्ट की सूची की वैल्यू सेट करना. |
selectionValue |
ड्रॉपडाउन से कोई एक वैल्यू चुनकर, चुनी गई वैल्यू सेट करना. |
selectionListValue |
ड्रॉपडाउन से कई वैल्यू चुनकर, चुनी गई वैल्यू की सूची की वैल्यू सेट करना. |
integerValue |
पूर्णांक वैल्यू सेट करना. |
userValue |
किसी एक उपयोगकर्ता को चुनकर, उपयोगकर्ता वैल्यू सेट करना. |
userListValue |
एक से ज़्यादा उपयोगकर्ताओं को चुनकर, उपयोगकर्ता सूची की वैल्यू सेट करना. |
dateValue |
तारीख की वैल्यू सेट करना. |
TextListValue
टेक्स्ट की सूची की वैल्यू सेट करना.
JSON के काेड में दिखाना |
---|
{ "values": [ string ] } |
फ़ील्ड | |
---|---|
values[] |
टेक्स्ट वैल्यू की activities.list. |
SelectionValue
ड्रॉपडाउन से कोई एक वैल्यू चुनकर, चुनी गई वैल्यू सेट करना.
JSON के काेड में दिखाना |
---|
{ "id": string, "displayName": string, "badged": boolean } |
फ़ील्ड | |
---|---|
id |
चुने गए आइटम का आइडेंटिफ़ायर. |
displayName |
चुने गए आइटम का डिसप्ले नेम. |
badged |
चुने गए आइटम पर बैज लगा है या नहीं. |
SelectionListValue
ड्रॉपडाउन से कई वैल्यू चुनकर, चुनी गई वैल्यू की सूची की वैल्यू सेट करना.
JSON के काेड में दिखाना |
---|
{
"values": [
{
object ( |
फ़ील्ड | |
---|---|
values[] |
activities.list of selections. |
UserValue
किसी एक उपयोगकर्ता को चुनकर, उपयोगकर्ता वैल्यू सेट करना.
JSON के काेड में दिखाना |
---|
{ "email": string } |
फ़ील्ड | |
---|---|
email |
उपयोगकर्ता का ईमेल पता. |
UserListValue
एक से ज़्यादा उपयोगकर्ताओं को चुनकर, उपयोगकर्ता सूची की वैल्यू सेट करना.
JSON के काेड में दिखाना |
---|
{
"values": [
{
object ( |
फ़ील्ड | |
---|---|
values[] |
उपयोगकर्ताओं की activities.list. |
तारीख
कैलेंडर की पूरी या कुछ तारीख दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन, कहीं और बताया गया है या यह जानकारी ज़रूरी नहीं है. तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:
- साल, महीने, और दिन की वैल्यू शून्य से ज़्यादा होनी चाहिए.
- साल के तौर पर शून्य के साथ महीना और दिन (उदाहरण के लिए, सालगिरह).
- साल, जिसमें महीना और दिन शून्य है.
- साल और महीना, जिसमें दिन की वैल्यू शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख.
मिलते-जुलते टाइप:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON के काेड में दिखाना |
---|
{ "year": integer, "month": integer, "day": integer } |
फ़ील्ड | |
---|---|
year |
तारीख का साल. यह संख्या 1 से 9999 के बीच होनी चाहिए. अगर साल के बिना तारीख बतानी है, तो 0 डालें. |
month |
साल का महीना. यह 1 से 12 के बीच की कोई संख्या होनी चाहिए. अगर महीने और दिन के बिना साल की जानकारी देनी है, तो 0 डालें. |
day |
महीने का दिन. यह वैल्यू 1 से 31 के बीच की होनी चाहिए. साथ ही, यह साल और महीने के लिए मान्य होनी चाहिए. इसके अलावा, साल या साल और महीने के लिए 0 भी डाला जा सकता है, जहां दिन की वैल्यू का कोई मतलब नहीं है. |
कारण
लेबल/फ़ील्ड लागू करने की वजह.
JSON के काेड में दिखाना |
---|
{ "reasonType": string } |
फ़ील्ड | |
---|---|
reasonType |
वजह किस तरह की है. |