- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति पाने के लिंक
- ApplicationName
- गतिविधि
- इसे आज़माएं!
किसी ग्राहक के खाते और ऐप्लिकेशन की गतिविधियों की सूची दिखाता है. जैसे, Admin console ऐप्लिकेशन या Google Drive ऐप्लिकेशन. ज़्यादा जानकारी के लिए, एडमिन और Google Drive की गतिविधि रिपोर्ट के लिए बनी गाइड देखें. गतिविधि रिपोर्ट के पैरामीटर के बारे में ज़्यादा जानने के लिए, गतिविधि पैरामीटर रेफ़रंस गाइड देखें.
एचटीटीपी अनुरोध
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
user |
उस प्रोफ़ाइल आईडी या उपयोगकर्ता के ईमेल पते को दिखाता है जिसके लिए डेटा फ़िल्टर किया जाना चाहिए. यह वैल्यू, पूरी जानकारी के लिए |
application |
उस ऐप्लिकेशन का नाम जिसके लिए इवेंट वापस लाने हैं. |
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
actor |
उस होस्ट का इंटरनेट प्रोटोकॉल (आईपी) पता जहां इवेंट हुआ था. यह रिपोर्ट की खास जानकारी को फ़िल्टर करने का एक और तरीका है. इसके लिए, उस उपयोगकर्ता के आईपी पते का इस्तेमाल किया जाता है जिसकी गतिविधि की शिकायत की जा रही है. यह आईपी पता, उपयोगकर्ता की जगह की जानकारी दिखा सकता है या नहीं. उदाहरण के लिए, आईपी पता, उपयोगकर्ता के प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (वीपीएन) का पता हो सकता है. यह पैरामीटर, IPv4 और IPv6, दोनों आईपी पते के वर्शन के साथ काम करता है. |
customer |
उस ग्राहक का यूनीक आईडी जिसके लिए डेटा पाना है. |
end |
रिपोर्ट में दिखाई गई समयसीमा के खत्म होने की तारीख सेट करता है. तारीख RFC 3339 फ़ॉर्मैट में है, जैसे कि 2010-10-28T10:26:35.000Z. डिफ़ॉल्ट वैल्यू, एपीआई अनुरोध का अनुमानित समय होता है. किसी एपीआई रिपोर्ट में, समय के तीन बुनियादी कॉन्सेप्ट होते हैं:
endTime की जानकारी नहीं दी गई है, तो रिपोर्ट में startTime से लेकर मौजूदा समय तक की सभी गतिविधियां दिखेंगी. अगर startTime की तारीख 180 दिन से पहले की है, तो रिपोर्ट में हाल के 180 दिनों की गतिविधियां दिखेंगी.
|
event |
उस इवेंट का नाम जिसकी जानकारी के लिए एपीआई क्वेरी कर रहा है. हर |
filters |
ये इवेंट पैरामीटर, किसी खास Drive गतिविधि के इन उदाहरणों में, दिखाई गई सूची में वे सभी
ध्यान दें: एपीआई एक ही पैरामीटर की कई वैल्यू स्वीकार नहीं करता. अगर एपीआई अनुरोध में किसी पैरामीटर को एक से ज़्यादा बार दिया जाता है, तो एपीआई सिर्फ़ उस पैरामीटर की आखिरी वैल्यू स्वीकार करता है. इसके अलावा, अगर एपीआई अनुरोध में कोई अमान्य पैरामीटर दिया जाता है, तो एपीआई उस पैरामीटर को अनदेखा कर देता है और बाकी मान्य पैरामीटर के हिसाब से जवाब दिखाता है. अगर किसी पैरामीटर का अनुरोध नहीं किया जाता है, तो सभी पैरामीटर दिखाए जाते हैं. |
max |
इससे यह तय होता है कि हर जवाब वाले पेज पर गतिविधि के कितने रिकॉर्ड दिखाए जाएं. उदाहरण के लिए, अगर अनुरोध |
org |
संगठन की उस इकाई का आईडी जिसकी रिपोर्ट करनी है. गतिविधि के रिकॉर्ड सिर्फ़ उन उपयोगकर्ताओं के लिए दिखाए जाएंगे जो चुनी गई संगठन की इकाई से जुड़े हैं. |
page |
अगले पेज की जानकारी देने वाला टोकन. एक से ज़्यादा पेजों वाली रिपोर्ट के रिस्पॉन्स में |
start |
रिपोर्ट में दिखाई गई समयसीमा की शुरुआत सेट करता है. तारीख, आरएफ़सी 3339 फ़ॉर्मैट में होनी चाहिए. उदाहरण के लिए, 2010-10-28T10:26:35.000Z. रिपोर्ट में |
group |
कॉमा से अलग किए गए ग्रुप आईडी (धुंधला किए गए), जिन पर उपयोगकर्ता गतिविधियों को फ़िल्टर किया जाता है. इसका मतलब है कि जवाब में सिर्फ़ उन उपयोगकर्ताओं की गतिविधियां शामिल होंगी जो यहां बताए गए कम से कम एक ग्रुप आईडी का हिस्सा हैं. फ़ॉर्मैट: "id:abc123,id:xyz456" |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
गतिविधियों के कलेक्शन के लिए JSON टेंप्लेट.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
फ़ील्ड | |
---|---|
kind |
एपीआई रिसॉर्स का टाइप. गतिविधि रिपोर्ट के लिए, वैल्यू |
etag |
संसाधन का ETag. |
items[] |
जवाब में हर गतिविधि का डेटा रिकॉर्ड किया जाता है. |
next |
रिपोर्ट के अगले पेज को फ़ॉलो करने के लिए टोकन. |
अनुमति के दायरे
नीचे दिए गए 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 ( |
फ़ील्ड | |
---|---|
kind |
एपीआई रिसॉर्स का टाइप. गतिविधि की रिपोर्ट की वैल्यू |
etag |
एंट्री का ETag. |
owner |
यह वह डोमेन है जिस पर रिपोर्ट के इवेंट का असर पड़ा है. उदाहरण के लिए, Admin console का डोमेन या Drive ऐप्लिकेशन के दस्तावेज़ का मालिक. |
ip |
कार्रवाई करने वाले उपयोगकर्ता का आईपी पता. यह Google Workspace में लॉग इन करते समय, उपयोगकर्ता का इंटरनेट प्रोटोकॉल (आईपी) पता होता है. इसमें उपयोगकर्ता की जगह की जानकारी हो भी सकती है और नहीं भी. उदाहरण के लिए, आईपी पता, उपयोगकर्ता के प्रॉक्सी सर्वर का पता या वर्चुअल प्राइवेट नेटवर्क (वीपीएन) का पता हो सकता है. यह एपीआई, IPv4 और IPv6 के साथ काम करता है. |
events[] |
रिपोर्ट में गतिविधि इवेंट. |
events[]. |
इवेंट का टाइप. Google Workspace की जिस सेवा या सुविधा में एडमिन बदलाव करता है उसकी पहचान |
events[]. |
इवेंट का नाम. यह एपीआई की रिपोर्ट की गई गतिविधि का खास नाम है. साथ ही, हर
eventName प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, ऊपर applicationName में दिए गए अलग-अलग ऐप्लिकेशन के इवेंट के नामों की सूची देखें.
|
events[]. |
अलग-अलग ऐप्लिकेशन के लिए पैरामीटर वैल्यू के पेयर. |
events[]. |
इस पैरामीटर से जुड़े नेस्ट किए गए पैरामीटर वैल्यू पेयर. किसी पैरामीटर के लिए कॉम्प्लेक्स वैल्यू टाइप, पैरामीटर वैल्यू की सूची के तौर पर दिखाया जाता है. उदाहरण के लिए, पते के पैरामीटर की वैल्यू |
events[]. |
पैरामीटर वैल्यू |
events[]. |
पैरामीटर का नाम. |
events[]. |
पैरामीटर की स्ट्रिंग वैल्यू. |
events[]. |
पैरामीटर की स्ट्रिंग वैल्यू. |
events[]. |
पैरामीटर की इंटीजर वैल्यू. |
events[]. |
पैरामीटर की पूर्णांक वैल्यू. |
events[]. |
पैरामीटर की बूलियन वैल्यू. |
events[]. |
|
events[]. |
पैरामीटर के मान |
id |
हर गतिविधि रिकॉर्ड के लिए यूनीक आइडेंटिफ़ायर. |
id. |
गतिविधि के होने का समय. यह यूनिक्स के टाइमस्टैंप में सेकंड में है. |
id. |
अगर एक से ज़्यादा इवेंट एक ही समय पर होते हैं, तो यूनीक क्वालिफ़ायर. |
id. |
उस ऐप्लिकेशन का नाम जिससे इवेंट जुड़ा है. संभावित वैल्यू के लिए, |
id. |
Google Workspace खाते का यूनीक आइडेंटिफ़ायर. |
actor |
कार्रवाई करने वाला उपयोगकर्ता. |
actor. |
उपयोगकर्ता का यूनीक Google Workspace प्रोफ़ाइल आईडी. अगर उपयोगकर्ता, Google Workspace का उपयोगकर्ता नहीं है या प्लेसहोल्डर आईडी के तौर पर काम करने वाला नंबर 105250506097979753968 हो सकता है, तो यह वैल्यू मौजूद नहीं होगी. |
actor. |
कलाकार का मुख्य ईमेल पता. अगर कलाकार का कोई ईमेल पता नहीं है, तो यह एट्रिब्यूट मौजूद नहीं हो सकता. |
actor. |
ऐक्टर का टाइप. |
actor. |
यह सिर्फ़ तब मौजूद होता है, जब |