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

عند إرسال طلب GET HTTP إلى واجهة برمجة التطبيقات، تعرض الاستجابة الناجحة رمز الحالة 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"
      }
      ]
     }
    ]
   },
  ]
 }