- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ApplicationName
खाता गतिविधियों के लिए सूचनाएं पाना शुरू करें. ज़्यादा जानकारी के लिए, पुश नोटिफ़िकेशन पाना लेख पढ़ें.
एचटीटीपी अनुरोध
POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch
यह यूआरएल 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" |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में SubscriptionChannel
का उदाहरण है.
जवाब का मुख्य भाग
संसाधनों में होने वाले बदलावों को देखने के लिए इस्तेमाल किया जाने वाला सूचना चैनल.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string } |
फ़ील्ड | |
---|---|
id |
एक यूयूआईडी या इससे मिलती-जुलती यूनीक स्ट्रिंग, जो इस चैनल की पहचान करती है. |
token |
इस चैनल पर भेजी गई हर सूचना के साथ, टारगेट पते पर डिलीवर की गई आर्बिट्रेरी स्ट्रिंग. ज़रूरी नहीं. |
expiration |
सूचना चैनल के खत्म होने की तारीख और समय, जिसे यूनिक्स टाइमस्टैंप के तौर पर मिलीसेकंड में दिखाया जाता है. ज़रूरी नहीं. |
type |
इस चैनल के लिए इस्तेमाल किया गया डिलीवरी का तरीका. वैल्यू, |
address |
वह पता जिस पर इस चैनल के लिए सूचनाएं भेजी जाती हैं. |
payload |
बूलियन वैल्यू से पता चलता है कि पेलोड चाहिए या नहीं. पेलोड ऐसा डेटा होता है जो एचटीटीपी POST, PUT या PATCH मैसेज के मुख्य हिस्से में भेजा जाता है. साथ ही, इसमें अनुरोध के बारे में अहम जानकारी होती है. ज़रूरी नहीं. |
params |
डिलीवरी चैनल के व्यवहार को कंट्रोल करने वाले अन्य पैरामीटर. ज़रूरी नहीं. एक ऑब्जेक्ट, जिसमें |
resourceId |
यह एक ओपेक आईडी है, जो इस चैनल पर देखे जा रहे संसाधन की पहचान करता है. एपीआई के अलग-अलग वर्शन में स्थिर है. |
resourceUri |
देखे गए संसाधन के लिए वर्शन के हिसाब से आइडेंटिफ़ायर. |
kind |
इसे किसी सूचना चैनल के तौर पर पहचाना गया है, जिसका इस्तेमाल किसी संसाधन में हुए बदलाव देखने के लिए किया जाता है. यह संसाधन " |
अनुमति के दायरे
नीचे दिए गए 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 और Google Workspace 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 के ग्राहकों के लिए उपलब्ध है. |