Reports API: Drive गतिविधि रिपोर्ट

Drive की गतिविधि रिपोर्ट में आपके उपयोगकर्ताओं की उन गतिविधियों की जानकारी मिलती है जब वे Google Workspace में Google Drive पर फ़ाइलों को मैनेज करते हैं, उनमें बदलाव करते हैं, और उन्हें शेयर करते हैं. उदाहरण के लिए, किसी उपयोगकर्ता ने तय तारीख की सीमा में, Drive में मौजूद जिन नए दस्तावेज़ों को बनाया है उनकी सूची देखने के लिए, Drive में होने वाली गतिविधि की रिपोर्ट का इस्तेमाल किया जा सकता है. इस जानकारी का इस्तेमाल बेहतर कॉन्टेंट मैनेजमेंट और संभावित डेटा लीक के बारे में जानने के लिए किया जा सकता है. रिपोर्ट पाने के लिए, आपको रिपोर्ट से जुड़े खास पैरामीटर के साथ बेसिक रिपोर्ट एंडपॉइंट अनुरोध का इस्तेमाल करना होता है, जैसे कि उपयोगकर्ता का ईमेल पता या Google Drive में किसी खास तरह का बदलाव. रिपोर्ट में पिछले 180 दिनों तक का डेटा शामिल हो सकता है.

Google Drive की गतिविधि रिपोर्ट का इस्तेमाल, सिर्फ़ उन खातों में कानूनी तौर पर किए जाने के लिए किया जा सकता है जिनके लिए लाइसेंस असाइन किया गया है.

अनुरोध की क्वेरी स्ट्रिंग और रिस्पॉन्स प्रॉपर्टी के बारे में जानने के लिए, एपीआई का रेफ़रंस देखें. Google Drive से जुड़े खास इवेंट की जानकारी के लिए, Drive में मौजूद इवेंट के नाम देखें.

किसी डोमेन के Google 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 डिस्क इवेंट फिर से पाएं

किसी खास तरह के इवेंट की रिपोर्ट पाने के लिए, जैसे कि दस्तावेज़ बनाना या उसमें बदलाव करना, अनुमति देने की गाइड में बताए गए ऑथराइज़ेशन टोकन के साथ एक एचटीटीपी 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"
      }
      ]
     }
    ]
   },
  ]
 }