Drive में की गई गतिविधि की रिपोर्ट, आपके उपयोगकर्ताओं की गतिविधियों के बारे में जानकारी देती है. ये गतिविधियां, Google Workspace में Google Drive में मौजूद फ़ाइलों को मैनेज, उनमें बदलाव, और उन्हें शेयर करते समय होती हैं. उदाहरण के लिए, आप डिस्क गतिविधि रिपोर्ट का उपयोग तारीख की एक खास सीमा में किसी खास उपयोगकर्ता के बनाए गए सभी नए डिस्क दस्तावेज़ों की सूची पाने के लिए कर सकते हैं. आप इस जानकारी का इस्तेमाल बेहतर सामग्री प्रबंधन और संभावित डेटा लीक की अहम जानकारी पाने के लिए कर सकते हैं. रिपोर्ट पाने के लिए, रिपोर्ट के खास पैरामीटर, जैसे कि उपयोगकर्ता के ईमेल पते या किसी खास तरह के Google Drive के बदलाव के साथ, बुनियादी एंडपॉइंट के अनुरोध का इस्तेमाल किया जाता है. रिपोर्ट में पिछले 180 दिनों तक का डेटा शामिल हो सकता है.
रिपोर्ट पाने के लिए एपीआई का इस्तेमाल करने से पहले, आपको रिपोर्ट एपीआई से जुड़ी ज़रूरी शर्तों में दिए गए चरणों को पूरा करना होगा.
Google Drive पर की गई गतिविधि की रिपोर्ट, सिर्फ़ उन ही खातों से इस्तेमाल की जा सकती है जिनके लिए लाइसेंस असाइन किया गया है.
अनुरोध की क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में जानकारी के लिए, एपीआई का संदर्भ देखें. Google Drive से जुड़े खास इवेंट की जानकारी के लिए, Drive इवेंट के नाम देखें.
किसी डोमेन के लिए Google 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 से जुड़ी गतिविधियों की रिपोर्ट पाने के लिए, ऑथराइज़ेशन गाइड में बताए गए ऑथराइज़ेशन टोकन का इस्तेमाल करके, एचटीटीपी 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
इवेंट बताएं. यहां दिए गए उदाहरण में 'शेयर की गई ड्राइव' में सदस्यों को जोड़ने के बारे में जानकारी मिलती है:
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 स्टेटस कोड दिखता है. स्थिति कोड के साथ, जवाब डिस्क के लिए
रिपोर्ट लौटाता है. ये रिपोर्ट, 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"
}
]
}
]
},
]
}