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