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

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

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

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

किसी डोमेन के लिए Google Drive के इवेंट वापस पाना

आप डिस्क गतिविधि रिपोर्ट का उपयोग अपनी Drive के दस्तावेज़. उदाहरण के लिए, रिपोर्ट की लिस्टिंग का अनुरोध किया जा सकता है आपके खाते के सबसे हाल के Drive इवेंट के 25 इवेंट. इनमें, ज़्यादा से ज़्यादा 180 इवेंट शामिल हैं दिन. इस रिपोर्ट को पाने के लिए, अनुमति से जुड़ी गाइड, फिर इसका इस्तेमाल करें नीचे दिया गया एचटीटीपी GET अनुरोध:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25

इस एपीआई कॉल के जवाब का उदाहरण देखा जा सकता है.

नीचे दिए गए उदाहरण में, सभी Drive की रिपोर्ट वापस ली गई है पिछले 180 दिनों के इवेंट, ज़्यादा से ज़्यादा अवधि.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

उपयोगकर्ता के अनुसार Google डिस्क इवेंट फिर से पाएं

किसी उपयोगकर्ता की Google Drive गतिविधियों की रिपोर्ट पाने के लिए, एचटीटीपी GET अनुरोध, जिसमें अनुमति वाले टोकन में बताया गया है अनुमति से जुड़ी गाइड गाइड. userKey फ़ील्ड, रिपोर्ट में मौजूद उपयोगकर्ता का मुख्य ईमे�� पता होता है या सभी उपयोगकर्ताओं के लिए all.

नीचे दिए गए उदाहरण में एक ऐसी रिपोर्ट दी गई है जिसमें किए गए सभी बदलावों की जानकारी दी गई है किसी उपयोगकर्ता को एक्सपोर्ट करने के लिए. एपीआई से मिले रिस्पॉन्स के उदाहरण के लिए, यहां देखें JSON का सैंपल.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

शेयर की गई ड्राइव के लिए Google Drive के इवेंट वापस पाएं

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