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

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

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

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

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

مثال زیر گزارشی از تمام فعالیت‌های مدیریتی حساب شما در ۱۸۰ روز گذشته دریافت می‌کند که حداکثر مدت زمان برای یک گزارش است. و رشته پرس و جوی maxResults تعیین می‌کند که این گزارش شامل دو رویداد در هر صفحه گزارش است. برای نمونه‌ای از پاسخ API، به مثال پاسخ JSON مراجعه کنید:

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

مثال زیر گزارشی از تمام فعالیت‌های مدیریتی یک مشتری در ۱۸۰ روز گذشته دریافت می‌کند. customerId مشخص می‌کند که گزارش برای کدام مشتری بازیابی شود.

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

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

برای بازیابی گزارش تمام فعالیت‌های کنسول مدیریت که توسط یک مدیر خاص انجام شده است، از درخواست 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 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": ""
       }
      ]
     }
    ]
   }
  ]
 }