Reports API: تقرير نشاط Drive

يقدّم تقرير نشاط Drive معلومات عن أنشطة المستخدمين عند إدارة الملفات وتعديلها ومشاركتها على Google Drive في Google Workspace. على سبيل المثال، يمكنك استخدام تقرير نشاط Drive للحصول على قائمة بجميع مستندات Drive الجديدة التي أنشأها مستخدم معيّن على مدار نطاق زمني محدّد. يمكنك استخدام هذه المعلومات للحصول على إحصاءات حول إدارة المحتوى بشكل أفضل وحالات تسرُّب البيانات المحتمَلة. للحصول على تقرير، يمكنك استخدام طلب نقطة نهاية التقرير الأساسي مع مَعلمات خاصة بالتقرير، مثل عنوان البريد الإلكتروني للمستخدم أو نوع معيّن من التغييرات في Google Drive. يمكن أن تشمل التقارير بيانات تصل إلى آخر 180 يومًا.

لا يجوز استخدام تقرير نشاط Google Drive إلا لأغراض قانونية في الحسابات التي تم منحها ترخيصًا.

للحصول على معلومات عن سلاسل طلبات البحث للطلب وسمات الاستجابة، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات. للحصول على معلومات عن أحداث معيّنة مرتبطة بخدمة Google Drive، اطّلِع على أسماء أحداث Drive.

استرداد أحداث Google Drive لنطاق

يمكنك استخدام تقرير نشاط Drive لعرض معلومات عن مستندات Drive. على سبيل المثال، يمكنك طلب تقرير يسرد آخر 25 حدثًا في Drive في حسابك، على مدار 180 يومًا كحد أقصى. للحصول على هذا التقرير، احصل على رمز مميّز للتفويض كما هو موضّح في دليل التفويض، ثم استخدِم طلب HTTP 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 Drive حسب المستخدم

لاسترداد تقرير عن أنشطة مستخدم معيّن على Google Drive، استخدِم طلب GET HTTP مع الرمز المميّز للتفويض الموضّح في دليل التفويض. حقل userKey هو عنوان البريد الإلكتروني الأساسي للمستخدم في التقرير، أو all لجميع المستخدمين.

يسترجع المثال التالي تقريرًا يسرد جميع التغييرات التي أجراها المستخدم المحدّد. للاطّلاع على مثال على استجابة واجهة برمجة التطبيقات، يمكنك الاطّلاع على نموذج استجابة JSON.

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

استرداد أحداث Google Drive لمساحات التخزين السحابي المشتركة

يمكنك استرداد تقرير عن أنشطة Google Drive لملف شخصي مشترَك معيّن في Drive باستخدام طلب HTTP 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 Drive حسب نوع الحدث

لاسترداد تقرير عن جميع نُسخ نوع حدث معيّن، مثل إنشاء أو تعديل مستند، استخدِم طلب HTTP GET مع رمز التفويض الموضّح في دليل التفويض. حقل userKey هو عنوان البريد الإلكتروني الأساسي للمستخدم في التقرير، أو all لجميع المستخدمين.

يستردّ المثال التالي تقريرًا عن جميع أنشطة إنشاء مستندات الحساب. للاطّلاع على مثال على استجابة واجهة برمجة التطبيقات، يمكنك الاطّلاع على نموذج استجابة JSON:

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

مثال على استجابة JSON

عند إرسال طلب HTTP GET إلى واجهة برمجة التطبيقات، تعرض الاستجابة الناجحة رمز الحالة HTTP 200. بالإضافة إلى رمز الحالة، تعرض الاستجابة تقريرًا لـ Drive. تتوفّر هذه التقارير أيضًا في وحدة تحكّم المشرف. لمزيد من المعلومات، يُرجى الاطّلاع على مركز مساعدة مشرفي 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"
      }
      ]
     }
    ]
   },
  ]
 }