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

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