- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ApplicationName
- गतिविधि
- इसे आज़माएं!
किसी खास ग्राहक के खाते और ऐप्लिकेशन के लिए गतिविधियों की सूची वापस लाता है. जैसे- 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 |
उस होस्ट का इंटरनेट प्रोटोकॉल (आईपी) पता जहां इवेंट किया गया था. यह उस उपयोगकर्ता के आईपी पते का इस्तेमाल करके, किसी रिपोर्ट की खास जानकारी को फ़िल्टर करने का एक और तरीका है जिसकी गतिविधि की शिकायत की जा रही है. यह आईपी पता, उपयोगकर्ता की जगह की जानकारी दिखा भी सकता है और नहीं भी. उदाहरण के लिए, आईपी पता उपयोगकर्ता के किसी प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (VPN) पता हो सकता है. यह पैरामीटर IPv4 और IPv6, दोनों वर्शन के साथ काम करता है. |
customerId |
डेटा वापस पाने के लिए ग्राहक का यूनीक आईडी. |
endTime |
रिपोर्ट में दिखाई गई समयसीमा की समयसीमा सेट करता है. तारीख RFC 3339 फ़ॉर्मैट में है, जैसे कि 2010-10-28T10:26:35.000Z. डिफ़ॉल्ट वैल्यू, एपीआई अनुरोध का अनुमानित समय होती है. एपीआई रिपोर्ट में समय से जुड़े तीन बुनियादी सिद्धांत होते हैं:
endTime के बारे में नहीं बताया गया है, तो रिपोर्ट में startTime से लेकर मौजूदा समय तक की सभी गतिविधियां दिखेंगी. इसके अलावा, अगर startTime पिछले 180 दिन से ज़्यादा का है, तो सबसे हाल के 180 दिनों तक की सभी गतिविधियां दिखती हैं.
|
eventName |
एपीआई के ज़रिए क्वेरी किए जा रहे इवेंट का नाम. हर |
filters |
ये इवेंट पैरामीटर, किसी खास Drive पर की गई गतिविधि के इन उदाहरणों में, ऐसी सभी
ध्यान दें: एपीआई एक ही पैरामीटर के एक से ज़्यादा वैल्यू को स्वीकार नहीं करता. अगर एपीआई अनुरोध में कोई पैरामीटर एक से ज़्यादा बार दिया जाता है, तो एपीआई उस पैरामीटर की आखिरी वैल्यू ही स्वीकार करता है. इसके अलावा, अगर एपीआई अनुरोध में कोई अमान्य पैरामीटर दिया गया है, तो एपीआई उस पैरामीटर को अनदेखा कर देता है और बाकी मान्य पैरामीटर से जुड़ा रिस्पॉन्स दिखाता है. अगर किसी पैरामीटर का अनुरोध नहीं किया जाता है, तो सभी पैरामीटर दिखाए जाते हैं. |
maxResults |
इससे यह तय होता है कि जवाब वाले हर पेज पर गतिविधि के कितने रिकॉर्ड दिखाए जाते हैं. उदाहरण के लिए, अगर अनुरोध, |
orgUnitID |
संगठन की इकाई का आईडी, जिसकी रिपोर्ट देखनी है. गतिविधि के रिकॉर्ड सिर्फ़ उन उपयोगकर्ताओं को दिखाए जाएंगे जो संगठन की किसी खास इकाई से जुड़े होंगे. |
pageToken |
अगला पेज बताने के लिए टोकन. कई पेजों वाली रिपोर्ट के रिस्पॉन्स में |
startTime |
रिपोर्ट में दिखाई गई समयसीमा की शुरुआत सेट करता है. तारीख RFC 3339 फ़ॉर्मैट में है, जैसे कि 2010-10-28T10:26:35.000Z. रिपोर्ट में, |
groupIdFilter |
कॉमा लगाकर अलग किए गए ग्रुप आईडी (उलझे हुए) जिन पर उपयोगकर्ता गतिविधियों को फ़िल्टर किया जाता है. इसका मतलब है कि रिस्पॉन्स में सिर्फ़ उन उपयोगकर्ताओं की गतिविधियां शामिल होंगी जो यहां बताए गए कम से कम किसी एक ग्रुप आईडी का हिस्सा हैं. फ़ॉर्मैट: "id:abc123,id:xyz456" |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
गतिविधियों के कलेक्शन के लिए 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 ऐप्लिकेशन की गतिविधि रिपोर्ट, कैलेंडर गतिविधि के कई इवेंट की जानकारी दिखाती हैं. |
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 ( |
फ़ील्ड | |
---|---|
kind |
एपीआई संसाधन का टाइप. गतिविधि की रिपोर्ट के लिए, वैल्यू |
etag |
एंट्री का ईटैग. |
ownerDomain |
इस डोमेन पर, रिपोर्ट के इवेंट का असर पड़ा है. उदाहरण के लिए, Admin console का डोमेन या Drive ऐप्लिकेशन के दस्तावेज़ का मालिक. |
ipAddress |
कार्रवाई करने वाले उपयोगकर्ता का आईपी पता. यह Google Workspace में लॉग इन करते समय, उपयोगकर्ता का इंटरनेट प्रोटोकॉल (आईपी) पता होता है. यह पता, उपयोगकर्ता की जगह की जानकारी दे सकता है और नहीं भी. उदाहरण के लिए, आईपी पता उपयोगकर्ता के किसी प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (VPN) पता हो सकता है. यह एपीआई 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[] |
पैरामीटर वैल्यू |
id |
हर गतिविधि के रिकॉर्ड के लिए यूनीक आइडेंटिफ़ायर. |
id.time |
गतिविधि होने का समय. यह सेकंड में UNIX epoch समय में होता है. |
id.uniqueQualifier |
एक से ज़्यादा इवेंट का एक ही समय होने पर यूनीक क्वालीफ़ायर. |
id.applicationName |
ऐप्लिकेशन का नाम, जिससे इवेंट संबंधित है. संभावित वैल्यू के लिए, |
id.customerId |
Google Workspace खाते के लिए यूनीक आइडेंटिफ़ायर. |
actor |
कार्रवाई करता उपयोगकर्ता. |
actor.profileId |
उपयोगकर्ता का Google Workspace प्रोफ़ाइल आईडी. अगर उपयोगकर्ता, Google Workspace का उपयोगकर्ता नहीं है, तो हो सकता है कि यह वैल्यू मौजूद न हो या 105250506097979753968 नंबर, प्लेसहोल्डर आईडी के तौर पर काम करता हो. |
actor.email |
उपयोगकर्ता का मुख्य ईमेल पता. अगर कलाकार से जुड़ा कोई ईमेल पता नहीं दिया गया है, तो हो सकता है कि यह जानकारी न दिखे. |
actor.callerType |
कलाकार किस तरह का है. |
actor.key |
सिर्फ़ तब मौजूद होता है, जब |