Drive में की गई गतिविधि की रिपोर्ट से, आपको Google Workspace में Google Drive पर फ़ाइलें मैनेज करने, उनमें बदलाव करने, और उन्हें शेयर करने के दौरान, उपयोगकर्ताओं की गतिविधियों के बारे में जानकारी मिलती है. उदाहरण के लिए, Drive में की गई गतिविधि की रिपोर्ट का इस्तेमाल करके, किसी खास उपयोगकर्ता की ओर से तय की गई तारीख की सीमा के दौरान बनाए गए सभी नए Drive दस्तावेज़ों की सूची पाई जा सकती है. इस जानकारी का इस्तेमाल करके, कॉन्टेंट को बेहतर तरीके से मैनेज करने और डेटा लीक होने की आशंका के बारे में अहम जानकारी पाई जा सकती है. रिपोर्ट पाने के लिए, रिपोर्ट से जुड़े पैरामीटर के साथ बेसिक रिपोर्ट एंडपॉइंट अनुरोध का इस्तेमाल किया जाता है. जैसे, उपयोगकर्ता का ईमेल पता या Google Drive में हुआ कोई खास बदलाव. रिपोर्ट में, पिछले 180 दिनों तक का डेटा शामिल किया जा सकता है.
Google Drive की गतिविधि रिपोर्ट का इस्तेमाल सिर्फ़ कानूनी कामों के लिए किया जा सकता है. ऐसा उन खातों में किया जा सकता है जिनके पास लाइसेंस है.
अनुरोध की क्वेरी स्ट्रिंग और जवाब की प्रॉपर्टी के बारे में जानकारी पाने के लिए, एपीआई का रेफ़रंस देखें. Google Drive से जुड़े कुछ इवेंट के बारे में जानकारी पाने के लिए, Drive के इवेंट के नाम देखें.
किसी डोमेन के लिए Google Drive इवेंट वापस पाना
Drive में की गई गतिविधि की रिपोर्ट का इस्तेमाल करके, Drive में मौजूद दस्तावेज़ों के बारे में जानकारी देखी जा सकती है. उदाहरण के लिए, आपके पास अपने खाते के 25 सबसे हाल के Drive इवेंट की सूची वाली रिपोर्ट का अनुरोध करने का विकल्प होता है. इसमें 180 दिनों तक का डेटा शामिल होता है. यह रिपोर्ट पाने के लिए, अनुमति से जुड़ी गाइड में बताए गए तरीके से अनुमति टोकन पाएं. इसके बाद, यहां दिए गए एचटीटीपी GET अनुरोध का इस्तेमाल करें:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
इस एपीआई कॉल का उदाहरण जवाब देखा जा सकता है.
यहां दिए गए उदाहरण में, पिछले 180 दिनों के सभी Drive इवेंट की रिपोर्ट वापस पाई जाती है. यह ज़्यादा से ज़्यादा अवधि है.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
उपयोगकर्ता के हिसाब से Google Drive के इवेंट वापस पाना
किसी उपयोगकर्ता की Google Drive गतिविधियों की रिपोर्ट पाने के लिए, अनुमति से जुड़ी गाइड में बताए गए ऑथराइज़ेशन टोकन के साथ HTTP GET अनुरोध का इस्तेमाल करें.
userKey फ़ील्ड, रिपोर्ट में मौजूद उपयोगकर्ता का प्राइमरी ईमेल पता है या
all सभी उपयोगकर्ताओं के लिए है.
यहां दिए गए उदाहरण में, किसी उपयोगकर्ता के किए गए सभी बदलावों की सूची वाली रिपोर्ट को वापस पाने का तरीका बताया गया है. एपीआई से मिले जवाब का उदाहरण देखने के लिए, JSON के जवाब का उदाहरण देखें.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
शेयर की गई ड्राइव के लिए, Google Drive के इवेंट वापस पाना
अनुमति देने से जुड़ी गाइड में बताए गए अनुमति वाले टोकन के साथ, एचटीटीपी GET अनुरोध का इस्तेमाल करके, किसी शेयर की गई ड्राइव के लिए Google Drive की गतिविधियों की रिपोर्ट वापस पाई जा सकती है. userKey फ़ील्ड में, उस उपयोगकर्ता का ईमेल पता डालें जिसके लिए आपको रिपोर्ट जनरेट करनी है. इसके अलावा, सभी उपयोगकर्ताओं के लिए रिपोर्ट जनरेट करने के लिए, all डालें.
यहां दिए गए उदाहरण में, किसी शेयर की गई ड्राइव में किए गए सभी बदलावों की रिपोर्ट वापस पाई जाती है. एपीआई से मिले जवाब का उदाहरण देखने के लिए, JSON के जवाब का उदाहरण देखें.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
शेयर की गई ड्राइव के इवेंट वापस पाने के लिए, doc_type का इस्तेमाल करके फ़िल्टर करें. यहां दिए गए उदाहरण में, उन इवेंट को वापस पाया जाता है जिनसे शेयर की गई सभी ड्राइव पर असर पड़ता है:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
सदस्यता में हुए बदलावों से जुड़े इवेंट वापस पाने के लिए, shared_drive_membership_change
event तय करें. यहां दिए गए उदाहरण में, शेयर की गई ड्राइव में जोड़े गए सभी सदस्यों की जानकारी मिलती है:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
इवेंट टाइप के हिसाब से Google Drive के इवेंट वापस पाना
किसी खास तरह के इवेंट के सभी इंस्टेंस की रिपोर्ट पाने के लिए, एचटीटीपी GET अनुरोध का इस्तेमाल करें. जैसे, किसी दस्तावेज़ को बनाना या उसमें बदलाव करना. इसके लिए, अनुमति देने से जुड़ी गाइड में बताया गया अनुमति देने वाला टोकन इस्तेमाल करें.
userKey फ़ील्ड, रिपोर्ट में मौजूद उपयोगकर्ता का प्राइमरी ईमेल पता है या
all सभी उपयोगकर्ताओं के लिए है.
यहां दिए गए उदाहरण में, खाते के दस्तावेज़ बनाने से जुड़ी सभी गतिविधियों की रिपोर्ट वापस पाई जाती है. एपीआई से मिले रिस्पॉन्स का उदाहरण देखने के लिए, JSON रिस्पॉन्स का सैंपल देखें:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
JSON रिस्पॉन्स का उदाहरण
एपीआई को एचटीटीपी GET अनुरोध भेजने पर, अनुरोध पूरा होने पर एचटीटीपी 200 स्टेटस कोड मिलता है. स्टेटस कोड के साथ-साथ, जवाब में Drive के लिए एक रिपोर्ट भी मिलती है. ये रिपोर्ट, Admin console में भी उपलब्ध हैं. ज़्यादा जानकारी के लिए, Google Workspace एडमिन सहायता केंद्र पर जाएं.
eventName जानकारी के लिए, Drive के इवेंट के नाम का रेफ़रंस देखें. अनुरोध की क्वेरी स्ट्रिंग और जवाब की प्रॉपर्टी के बारे में ज़्यादा जानकारी के लिए, एपीआई का रेफ़रंस देखें.
{
"kind": "reports#auditActivities",
"nextPageToken": "next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2014-03-17T15:39:18.460Z",
"uniqQualifier": "report's unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"callerType": "USER",
"email": "kim@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "domain of the source owner",
"ipAddress": "user's IP address",
"events": [
{
"type": "access",
"name": "edit",
"parameters": [
{
"name": "primary_event",
"boolValue": true
},
{
"name": "owner_is_shared_drive",
"boolValue": false
}, {
"name": "doc_id",
"value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
},
{
"name": "doc_title",
"value": "Meeting notes"
},
{
"name": "doc_type",
"value": "document"
},
{
"name": "owner",
"value": "mary@example.com"
}
]
}
]
},
]
}