گزارش فعالیت ادمین

گزارش فعالیت سرپرست، اطلاعات مربوط به فعالیت‌های کنسول مدیریت تمامی مدیران حساب شما را برمی‌گرداند. هر گزارش از درخواست نقطه پایانی گزارش اولیه با پارامترهای خاص گزارش مانند نام مدیر یا یک رویداد خاص کنسول مدیریت استفاده می کند. حداکثر دوره زمانی برای هر گزارش 180 روز گذشته است.

گزارش فعالیت مدیر ممکن است فقط برای اهداف قانونی مطابق با توافق نامه مشتری شما استفاده شود. و این گزارش‌ها برای حساب‌های Google Workspace، Education و ISP اعمال می‌شود.

بازیابی تمام فعالیت های اداری

برای بازیابی گزارشی از تمام فعالیت‌های اداری انجام شده برای یک حساب، از درخواست GET HTTP زیر استفاده کنید و کد مجوز شرح داده شده در اسناد مجوز را اضافه کنید. برای اطلاعات بیشتر درباره رشته‌های پرس و جو درخواست و ویژگی‌های پاسخ، به مرجع API مراجعه کنید. برای خوانایی، مثال زیر با بازگشت خط فرمت شده است:

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 مشخص می کند که این گزارش حاوی دو رویداد در هر صفحه گزارش است. برای مثالی از پاسخ API، به مثال پاسخ 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

بازیابی همه فعالیت ها توسط مدیر

برای بازیابی گزارشی از تمام فعالیت‌های کنسول Admin که توسط یک سرپرست خاص انجام شده است، از درخواست GET HTTP زیر استفاده کنید و کد مجوز توضیح داده شده در اسناد مجوز را اضافه کنید. userKey آدرس ایمیل اصلی مدیر در گزارش است. برای اطلاعات بیشتر درباره رشته‌های پرس و جو درخواست و ویژگی‌های پاسخ، به مرجع API مراجعه کنید. برای خوانایی، مثال زیر با بازگشت خط فرمت شده است:

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

همه فعالیت ها را با نام رویداد بازیابی کنید

برای بازیابی گزارشی از همه فعالیت‌ها برای یک نام رویداد خاص، از درخواست GET HTTP زیر استفاده کنید و کد مجوز شرح داده شده در اسناد مجوز را اضافه کنید. برای اطلاعات eventName ، به اطلاعات مرجع نام رویدادهای مدیر مراجعه کنید. برای اطلاعات بیشتر درباره رشته‌های پرس و جو درخواست و ویژگی‌های پاسخ، به مرجع API مراجعه کنید. برای خوانایی، مثال زیر با بازگشت خط فرمت شده است:

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

مثال زیر گزارشی را برای تمام نمونه‌های کنسول مدیریت تغییر نام خانوادگی کاربر بازیابی می‌کند. برای مثالی از پاسخ API، به مثال پاسخ JSON مراجعه کنید:

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

همه فعالیت ها را بر اساس رویداد و مدیر بازیابی کنید

برای بازیابی گزارشی از تمام تغییرات کنسول مدیریت برای یک نام رویداد خاص که توسط یک سرپرست خاص انجام شده است، از درخواست GET HTTP زیر استفاده کنید و کد مجوز شرح داده شده در اسناد مجوز را اضافه کنید. userKey آدرس ایمیل اصلی مدیر در گزارش است. برای اطلاعات eventName ، به اطلاعات مرجع نام رویدادهای مدیر مراجعه کنید. برای اطلاعات بیشتر درباره رشته‌های پرس و جو درخواست و ویژگی‌های پاسخ، به مرجع API مراجعه کنید. برای خوانایی، مثال زیر با بازگشت خط فرمت شده است:

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 انجام شده است، بازیابی می کند. برای مثالی از پاسخ API، به مثال پاسخ 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 درخواست و ویژگی‌های پاسخ، به مرجع API مراجعه کنید.

{
 "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": ""
       }
      ]
     }
    ]
   }
  ]
 }