Reports API: گزارش فعالیت Drive

گزارش فعالیت Drive اطلاعاتی درباره فعالیت‌های کاربران شما در هنگام مدیریت، تغییر و اشتراک‌گذاری فایل‌ها در Google Drive در Google Workspace ارائه می‌کند. به عنوان مثال، می توانید از گزارش فعالیت Drive برای دریافت لیستی از تمام اسناد Drive جدید ایجاد شده توسط یک کاربر خاص در بازه زمانی مشخصی از تاریخ استفاده کنید. می توانید از این اطلاعات برای به دست آوردن بینشی در مورد مدیریت بهتر محتوا و نشت داده های احتمالی استفاده کنید. برای دریافت گزارش، از درخواست نقطه پایانی گزارش اولیه با پارامترهای گزارش خاص مانند آدرس ایمیل کاربر یا نوع خاصی از تغییر Google Drive استفاده می‌کنید. گزارش‌ها می‌توانند شامل داده‌های حداکثر 180 روز گذشته باشند.

گزارش فعالیت Google Drive فقط برای اهداف قانونی در حساب‌هایی که دارای مجوز اختصاص داده شده‌اند استفاده می‌شود.

برای اطلاعات در مورد رشته های پرس و جو درخواست و ویژگی های پاسخ، به مرجع API مراجعه کنید. برای کسب اطلاعات درباره رویدادهای خاص مرتبط با Google Drive، به نام رویدادهای Drive مراجعه کنید.

رویدادهای Google Drive را برای یک دامنه بازیابی کنید

می‌توانید از گزارش فعالیت Drive برای فهرست کردن اطلاعات مربوط به اسناد Drive خود استفاده کنید. برای مثال، می‌توانید گزارشی را درخواست کنید که ۲۵ رویداد اخیر Drive حسابتان را فهرست می‌کند که حداکثر ۱۸۰ روز را پوشش می‌دهد. برای دریافت این گزارش، همانطور که در راهنمای مجوز توضیح داده شده است، یک نشانه مجوز دریافت کنید، سپس از درخواست HTTP GET زیر استفاده کنید:

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

می توانید یک نمونه پاسخ به این تماس API را ببینید.

مثال زیر گزارشی از تمام رویدادهای Drive در 180 روز گذشته، حداکثر دوره، بازیابی می‌کند.

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

رویدادهای Google Drive را توسط کاربر بازیابی کنید

برای بازیابی گزارشی از فعالیت‌های Google Drive یک کاربر خاص، از یک درخواست HTTP GET با نشانه مجوز توضیح داده شده در راهنمای راهنمای مجوز استفاده کنید. فیلد userKey آدرس ایمیل اصلی کاربر در گزارش یا all برای همه کاربران است.

مثال زیر گزارشی را بازیابی می کند که تمام تغییرات ایجاد شده توسط کاربر مشخص شده را فهرست می کند. برای مثالی از پاسخ API، نمونه پاسخ JSON را ببینید.

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

رویدادهای Google Drive را برای درایوهای مشترک بازیابی کنید

می‌توانید گزارشی از فعالیت‌های Google Drive را برای یک درایو مشترک خاص با استفاده از یک درخواست HTTP GET با کد مجوز توضیح داده شده در راهنمای مجوز بازیابی کنید. آدرس ایمیل کاربری را که می خواهید گزارش را روی آن اجرا کنید در قسمت userKey مشخص کنید یا all برای اجرای گزارش روی همه کاربران مشخص کنید.

مثال زیر گزارشی از تمام تغییرات یک درایو مشترک خاص را بازیابی می کند. برای مثالی از پاسخ API، نمونه پاسخ 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 را بر اساس نوع رویداد بازیابی کنید

برای بازیابی گزارشی از تمام نمونه‌های یک نوع رویداد خاص، مانند ایجاد یا ویرایش یک سند، از یک درخواست HTTP GET با کد مجوز توضیح داده شده در راهنمای مجوز استفاده کنید. فیلد userKey آدرس ایمیل اصلی کاربر در گزارش یا all برای همه کاربران است.

مثال زیر گزارشی از تمام فعالیت های ایجاد مستندات حساب را بازیابی می کند. برای نمونه ای از پاسخ API، نمونه پاسخ JSON را ببینید:

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

نمونه پاسخ JSON

وقتی یک درخواست HTTP GET به API می‌کنید، یک پاسخ موفق، کد وضعیت HTTP 200 را برمی‌گرداند. به همراه کد وضعیت، پاسخ گزارشی را برای Drive برمی‌گرداند. این گزارش ها در کنسول Admin نیز موجود است. برای اطلاعات بیشتر، به مرکز راهنمای Google Workspace Admin مراجعه کنید. برای اطلاعات eventName ، به مرجع نام‌های رویداد Drive مراجعه کنید. برای اطلاعات بیشتر درباره رشته‌های پرس و جو درخواست و ویژگی‌های پاسخ، به مرجع API مراجعه کنید.

{
 "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": "[email protected]",
   "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": "[email protected]"
      }
      ]
     }
    ]
   },
  ]
 }