Laporan Aktivitas Admin

Laporan aktivitas admin menampilkan informasi tentang aktivitas konsol Admin semua administrator akun Anda. Setiap laporan menggunakan permintaan endpoint laporan dasar dengan parameter spesifik per laporan, seperti nama administrator atau peristiwa konsol Admin tertentu. Jangka waktu maksimum untuk setiap laporan adalah 180 hari terakhir.

Laporan aktivitas admin hanya dapat digunakan untuk tujuan yang sah sesuai dengan Perjanjian Pelanggan Anda. Dan laporan ini berlaku untuk akun Google Workspace, Education, dan ISP.

Mengambil semua aktivitas administratif

Untuk mengambil laporan semua aktivitas administratif yang dilakukan untuk sebuah akun, gunakan permintaan HTTP GET berikut dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, baca Referensi API. Agar mudah dibaca, contoh berikut diformat dengan baris yang ditampilkan:

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

Contoh berikut mendapatkan laporan tentang semua aktivitas administratif akun Anda selama 180 hari terakhir yang merupakan jangka waktu maksimum untuk laporan. Dan string kueri maxResults menentukan bahwa laporan ini berisi dua peristiwa per halaman laporan. Untuk contoh respons API, lihat contoh respons JSON:

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

Contoh berikut mendapatkan laporan tentang semua aktivitas administratif pelanggan selama 180 hari terakhir. customerId menentukan pelanggan mana yang akan diambil laporannya.

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

Mengambil semua aktivitas oleh administrator

Untuk mengambil laporan semua aktivitas konsol Admin yang dilakukan oleh administrator tertentu, gunakan permintaan HTTP GET berikut dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. userKey adalah alamat email utama administrator dalam laporan. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, baca Referensi API. Agar mudah dibaca, contoh berikut diformat dengan baris yang ditampilkan:

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

Contoh berikut mendapatkan laporan tentang semua perubahan pada aplikasi konsol Admin yang dilakukan oleh john@example.com, dan responsnya difilter untuk menampilkan aktivitas apa pun yang memiliki OLD_VALUE sama dengan ALLOW_CAMERA. Untuk contoh respons API, lihat contoh respons JSON. Untuk mengetahui informasi tentang aktivitas, lihat nama peristiwa administrator:

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

Mengambil semua aktivitas berdasarkan nama peristiwa

Untuk mengambil laporan semua aktivitas untuk nama peristiwa tertentu, gunakan permintaan HTTP GET berikut dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. Untuk mengetahui informasi eventName, lihat informasi referensi nama peristiwa administrator. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, baca Referensi API. Agar mudah dibaca, contoh berikut diformat dengan baris yang ditampilkan:

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

Contoh berikut mengambil laporan untuk semua instance konsol Admin terkait perubahan nama belakang pengguna. Untuk contoh respons API, lihat contoh respons JSON:

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

Ambil semua aktivitas menurut peristiwa dan administrator

Untuk mengambil laporan semua perubahan konsol Admin untuk nama peristiwa tertentu yang dilakukan oleh administrator tertentu, gunakan permintaan HTTP GET berikut dan sertakan token otorisasi yang dijelaskan dalam dokumentasi otorisasi. userKey adalah alamat email utama administrator dalam laporan. Untuk mengetahui informasi eventName, lihat informasi referensi nama peristiwa administrator. Untuk mengetahui informasi selengkapnya tentang string kueri permintaan dan properti respons, baca Referensi API. Agar mudah dibaca, contoh berikut diformat dengan baris yang ditampilkan:

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

Contoh berikut mengambil laporan untuk semua perubahan konsol Admin pada nama belakang pengguna tertentu yang dilakukan oleh john@example.com. Untuk contoh respons API, lihat contoh respons JSON:

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

Contoh respons JSON laporan aktivitas admin

Respons yang berhasil akan menampilkan kode status HTTP 200. Bersama dengan kode status, respons akan menampilkan laporan. Untuk mengetahui informasi eventName, lihat informasi referensi nama peristiwa administrator. Untuk mengetahui informasi selengkapnya tentang string kueri URL dan properti respons permintaan, baca Referensi 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": ""
       }
      ]
     }
    ]
   }
  ]
 }