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 لمستخدم معيّن، استخدِم طلب HTTP GET مع الرمز المميّز للتفويض الموضح في دليل دليل التفويض. الحقل userKey هو عنوان البريد الإلكتروني الرئيسي للمستخدم في التقرير، أو all لجميع المستخدمين.

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

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

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

يمكنك استرداد تقرير عن أنشطة Google 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"
      }
      ]
     }
    ]
   },
  ]
 }