تقرير نشاط المشرف

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

لا يجوز استخدام تقرير نشاط المشرف إلا لأغراض قانونية بما يتوافق مع "اتفاقية العميل". وتنطبق هذه التقارير على حسابات Google Workspace وEducation وحسابات مزوّد خدمة الإنترنت.

استرداد جميع الأنشطة الإدارية

لاسترداد تقرير بجميع الأنشطة الإدارية التي تم إجراؤها في حساب، استخدِم طلب HTTP GET التالي وضمِّن الرمز المميّز للتفويض في مستندات التفويض. للمزيد من المعلومات حول سلاسل طلبات البحث في الطلب وخصائص الاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات. لسهولة القراءة، يتم تنسيق المثال التالي بإرجاع الأسطر:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report

يحصل المثال التالي على تقرير عن جميع الأنشطة الإدارية في حسابك خلال آخر 180 يومًا، وهو الحد الأقصى للفترة الزمنية للتقرير. وتحدّد سلسلة طلب البحث maxResults أنّ هذا التقرير يحتوي على حدثَين لكل صفحة من صفحات التقرير. للحصول على مثال على استجابة واجهة برمجة التطبيقات، يمكنك الاطّلاع على مثال استجابة JSON:

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

يحصل المثال التالي على تقرير عن جميع الأنشطة الإدارية للعميل خلال آخر 180 يومًا. تحدّد customerId العميل الذي سيتم استرداد التقرير له.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?customerId=C03az79cb

استرداد جميع الأنشطة بواسطة المشرف

لاسترداد تقرير بجميع أنشطة "وحدة تحكّم المشرف" التي نفّذها مشرف محدّد، استخدِم طلب HTTP GET التالي وضمِّن رمز التفويض المميز الموضّح في مستندات التفويض. userKey هو عنوان البريد الإلكتروني الرئيسي للمشرف الوارد في التقرير. للمزيد من المعلومات حول سلاسل طلبات البحث في الطلب وخصائص الاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات. لسهولة القراءة، يتم تنسيق المثال التالي بإرجاع الأسطر:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report
&filters=event name parameter relational operator parameter value

يحصل المثال التالي على تقرير عن جميع التغييرات التي أجرتها john@example.com على تطبيق "وحدة تحكُّم المشرف"، وتتم فلترة الاستجابة لعرض أي أنشطة تشتمل على OLD_VALUE تساوي ALLOW_CAMERA. للاطّلاع على مثال لاستجابة واجهة برمجة التطبيقات، يمكنك الاطّلاع على مثال على استجابة JSON. وللحصول على معلومات عن الأنشطة، اطّلِع على أسماء أحداث المشرف:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA

استرداد جميع الأنشطة حسب اسم الحدث

لاسترداد تقرير بجميع الأنشطة لاسم حدث محدّد، استخدِم طلب HTTP GET التالي وضمِّن الرمز المميز للتفويض الموضح في مستندات التفويض. للحصول على معلومات eventName، اطّلِع على المعلومات المرجعية لأسماء أحداث المشرف. للمزيد من المعلومات حول سلاسل طلبات البحث في الطلب وخصائص الاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات. لسهولة القراءة، يتم تنسيق المثال التالي بإرجاع الأسطر:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event

يسترد المثال التالي تقريرًا لجميع نُسخ "وحدة تحكُّم المشرف" التي تغيّر اسم العائلة لمستخدم. للحصول على مثال على استجابة واجهة برمجة التطبيقات، يمكنك الاطّلاع على مثال استجابة JSON:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

استرداد جميع الأنشطة حسب الحدث والمشرف

لاسترداد تقرير بجميع التغييرات التي أُجريت على "وحدة تحكُّم المشرف" لاسم حدث محدّد أجراه مشرف محدّد، استخدِم طلب HTTP GET التالي وضمِّن رمز التفويض المميز الموضّح في مستندات التفويض. userKey هو عنوان البريد الإلكتروني الرئيسي للمشرف الوارد في التقرير. للحصول على معلومات eventName، اطّلِع على المعلومات المرجعية لأسماء أحداث المشرف. للمزيد من المعلومات حول سلاسل طلبات البحث في الطلب وخصائص الاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات. لسهولة القراءة، يتم تنسيق المثال التالي بإرجاع الأسطر:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event

يسترد المثال التالي تقريرًا بجميع التغييرات التي تم إجراؤها على "وحدة تحكُّم المشرف" لاسم العائلة لمستخدم محدَّد التي تم إجراؤها من قِبل "john@example.com". للحصول على مثال على استجابة واجهة برمجة التطبيقات، يمكنك الاطّلاع على مثال استجابة JSON:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME

مثال على استجابة JSON لتقرير نشاط المشرف

تعرض الاستجابة الناجحة رمز حالة HTTP 200. إلى جانب رمز الحالة، يتم عرض تقرير للاستجابة. للحصول على معلومات eventName، اطّلِع على المعلومات المرجعية لأسماء أحداث المشرف. للمزيد من المعلومات حول سلاسل طلبات البحث لعنوان URL الخاص بالطلب وخصائص الاستجابة، يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.

{
 "kind": "reports#auditActivities",
 "nextPageToken": "the next page's token",
 "items": [
  {
   "kind": "audit#activity",
   "id": {
    "time": "2011-06-17T15:39:18.460Z",
    "uniqueQualifier": "report's unique ID",
    "applicationName": "admin",
    "customerId": "C03az79cb"
   },
   "actor": {
    "callerType": "USER",
    "email": "liz@example.com",
    "profileId": "user's unique Google Workspace profile ID",
    "key": "consumer key of requestor in OAuth 2LO requests"
   },
   "ownerDomain": "example.com",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "GROUP_SETTINGS",
     "name": "CHANGE_GROUP_SETTING",
     "parameters": [
      {
        "name": "SETTING_NAME",
        "value": "WHO_CAN_JOIN",
        "intValue": "integer value of parameter",
        "boolValue": "boolean value of parameter"
      }
     ]
    }
   ]
  },
  {
   "kind": "audit#activity",
   "id": {
    "time": "2011-06-17T15:39:18.460Z",
    "uniqueQualifier": "reports unique ID",
    "applicationName": "admin",
    "customerId": "C03az79cb"
   },
   "actor": {
    "callerType": "USER",
    "email": "liz@example.com",
    "profileId": "user's unique Google Workspace profile ID",
    "key": "consumer key of requestor in an OAuth 2LO request"
   },
   "ownerDomain": "example.com",
   "ipAddress": "user's IP address",
   "events": [
    {
     "type": "GROUP_SETTINGS",
     "name": "CREATE_GROUP",
     "parameters": [
      {
        "name": "GROUP_EMAIL",
        "value": "helpdesk@example.com",
        "intValue": "",
        "boolValue": ""
       }
      ]
     }
    ]
   }
  ]
 }