تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

يعرض تقرير نشاط المشرف معلومات عن أنشطة وحدة تحكُّم المشرف لجميع مشرفي حسابك. يستخدم كل تقرير طلب نقطة نهاية التقرير الأساسي مع المَعلمات الخاصة بالتقرير مثل اسم المشرف أو حدث محدّد في "وحدة تحكّم المشرف". الحد الأقصى للفترة الزمنية لكل تقرير هو آخر 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

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

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

لاسترداد تقرير بجميع التغييرات التي تم إجراؤها على "وحدة تحكُّم المشرف" لاسم حدث معيّن أجراه مشرف مُعيَّن، يمكنك استخدام طلب 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": ""
       }
      ]
     }
    ]
   }
  ]
 }