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 لمحتوى مشترك محدد 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"
      }
      ]
     }
    ]
   },
  ]
 }