Method: activities.list

string

Menampilkan ID profil atau email pengguna yang datanya harus difilter. Dapat berupa all untuk semua informasi, atau userKey untuk ID profil Google Workspace unik pengguna atau alamat email utama mereka. Bukan pengguna yang dihapus. Untuk pengguna yang dihapus, panggil users.list di Directory API dengan showDeleted=true, lalu gunakan ID yang ditampilkan sebagai userKey.

enum (ApplicationName)

Nama aplikasi yang peristiwanya akan diambil.

string

Alamat Protokol Internet (IP) host tempat peristiwa dilakukan. Tindakan ini adalah cara tambahan untuk memfilter ringkasan laporan menggunakan alamat IP pengguna yang aktivitasnya dilaporkan. Alamat IP ini mungkin mencerminkan atau tidak mencerminkan lokasi fisik pengguna. Misalnya, alamat IP dapat berupa alamat server proxy pengguna atau alamat virtual private network (VPN). Parameter ini mendukung versi alamat IPv4 dan IPv6.

string

ID unik pelanggan yang datanya akan diambil.

string

Menetapkan akhir rentang waktu yang ditampilkan dalam laporan. Tanggal dalam format RFC 3339, misalnya 2010-10-28T10:26:35.000Z. Nilai defaultnya adalah perkiraan waktu permintaan API. Laporan API memiliki tiga konsep waktu dasar:

• Tanggal permintaan API untuk laporan: Saat API membuat dan mengambil laporan.
• Waktu mulai laporan: Awal rentang waktu yang ditampilkan dalam laporan. startTime harus sebelum endTime (jika ditentukan) dan waktu saat ini saat permintaan dibuat, atau API akan menampilkan error.
• Waktu berakhir laporan: Akhir rentang waktu yang ditampilkan dalam laporan. Misalnya, rentang waktu peristiwa yang diringkas dalam laporan dapat dimulai pada bulan April dan berakhir pada bulan Mei. Laporan itu sendiri dapat diminta pada bulan Agustus.

string

Nama peristiwa yang dikueri oleh API. Setiap eventName terkait dengan layanan atau fitur Google Workspace tertentu yang disusun oleh API ke dalam jenis peristiwa. Contohnya adalah acara Google Kalender di laporan aplikasi konsol Admin. Struktur type Setelan Kalender memiliki semua aktivitas eventName Kalender yang dilaporkan oleh API. Saat administrator mengubah setelan Kalender, API melaporkan aktivitas ini dalam parameter Setelan Kalender type dan eventName. Untuk informasi selengkapnya tentang parameter dan string kueri eventName, lihat daftar nama peristiwa untuk berbagai aplikasi di atas dalam applicationName.

string

String kueri filters adalah daftar yang dipisahkan koma yang terdiri dari parameter peristiwa yang dimanipulasi oleh operator relasional. Parameter peristiwa tersedia dalam bentuk {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Parameter peristiwa ini dikaitkan dengan eventName tertentu. Laporan kosong akan ditampilkan jika parameter permintaan bukan bagian dari eventName. Untuk informasi selengkapnya tentang kolom eventName yang tersedia untuk setiap aplikasi dan parameter terkait, buka tabel ApplicationName, lalu klik halaman Peristiwa Aktivitas di Lampiran untuk aplikasi yang Anda inginkan.

Dalam contoh aktivitas Drive berikut, daftar yang ditampilkan terdiri dari semua peristiwa edit dengan nilai parameter doc_id yang cocok dengan kondisi yang ditentukan oleh operator relasional. Pada contoh pertama, permintaan menampilkan semua dokumen yang diedit dengan nilai doc_id sama dengan 12345. Pada contoh kedua, laporan menampilkan dokumen yang diedit yang nilai doc_id-nya tidak sama dengan 98765. Operator <> dienkode ke URL dalam string kueri permintaan (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

Kueri filters mendukung operator relasional ini:

• ==—'sama dengan'.
• <>—'tidak sama dengan'. Harus dienkode ke URL (%3C%3E).
• <—'lebih sedikit dari'. Harus dienkode ke URL (%3C).
• <=—'kurang dari atau sama dengan'. Harus dienkode ke URL (%3C=).
• >—'lebih dari'. Harus dienkode ke URL (%3E).
• >=—'lebih dari atau sama dengan'. Harus dienkode ke URL (%3E=).

Catatan: API tidak menerima beberapa nilai untuk parameter yang sama. Jika parameter diberikan lebih dari sekali dalam permintaan API, API hanya akan menerima nilai terakhir parameter tersebut. Selain itu, jika parameter yang tidak valid diberikan dalam permintaan API, API akan mengabaikan parameter tersebut dan menampilkan respons yang sesuai dengan parameter valid yang tersisa. Jika tidak ada parameter yang diminta, semua parameter akan ditampilkan.

integer

Menentukan berapa banyak catatan aktivitas yang ditampilkan di setiap halaman respons. Misalnya, jika permintaan menetapkan maxResults=1 dan laporan memiliki dua aktivitas, laporan ini akan memiliki dua halaman. Properti nextPageToken respons memiliki token ke halaman kedua. String kueri maxResults bersifat opsional dalam permintaan. Nilai defaultnya adalah 1.000.

string

ID unit organisasi yang akan dilaporkan. Catatan aktivitas hanya akan ditampilkan untuk pengguna yang menjadi bagian dari unit organisasi yang ditentukan.

string

Token untuk menentukan halaman berikutnya. Sebuah laporan dengan beberapa halaman memiliki properti nextPageToken dalam responsnya. Dalam permintaan selanjutnya untuk mendapatkan halaman laporan berikutnya, masukkan nilai nextPageToken dalam string kueri pageToken.

string

Menetapkan awal rentang waktu yang ditampilkan dalam laporan. Tanggal dalam format RFC 3339, misalnya 2010-10-28T10:26:35.000Z. Laporan menampilkan semua aktivitas dari startTime sampai endTime. startTime harus sebelum endTime (jika ditentukan) dan waktu saat ini saat permintaan dibuat, atau API akan menampilkan error.

string

ID grup yang dipisahkan koma (di-obfuscate) tempat aktivitas pengguna difilter, yaitu respons akan berisi aktivitas hanya untuk pengguna yang merupakan bagian dari setidaknya salah satu ID grup yang disebutkan di sini. Format: "id:abc123,id:xyz456"

{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}

string

Jenis resource API. Untuk laporan aktivitas, nilainya adalah audit#activity.

string

ETag entri.

string

Ini adalah domain yang terpengaruh oleh peristiwa laporan. Misalnya domain konsol Admin atau pemilik dokumen aplikasi Drive.

string

Alamat IP pengguna yang melakukan tindakan. Ini adalah alamat Protokol Internet (IP) pengguna saat login ke Google Workspace, yang mungkin atau mungkin tidak mencerminkan lokasi fisik pengguna. Misalnya, alamat IP dapat berupa alamat server proxy pengguna atau alamat virtual private network (VPN). API ini mendukung IPv4 dan IPv6.

object

Peristiwa aktivitas dalam laporan.

string

Jenis peristiwa. Layanan atau fitur Google Workspace yang diubah administrator diidentifikasi di properti type yang mengidentifikasi peristiwa menggunakan properti eventName. Untuk mengetahui daftar lengkap kategori type API, lihat daftar nama peristiwa untuk berbagai aplikasi di atas di applicationName.

string

Nama peristiwa. Ini adalah nama spesifik aktivitas yang dilaporkan oleh API. Selain itu, setiap eventName terkait dengan layanan atau fitur Google Workspace tertentu yang disusun oleh API ke dalam jenis peristiwa.
Untuk parameter permintaan eventName secara umum:

• Jika tidak ada eventName yang diberikan, laporan akan menampilkan semua kemungkinan instance dari eventName.
• Saat Anda meminta eventName, respons API akan menampilkan semua aktivitas yang berisi eventName tersebut.

object

Pasangan nilai parameter untuk berbagai aplikasi. Untuk informasi selengkapnya tentang parameter eventName, lihat daftar nama peristiwa untuk berbagai aplikasi di atas di applicationName.

object

Pasangan nilai parameter bertingkat yang terkait dengan parameter ini. Jenis nilai kompleks untuk parameter ditampilkan sebagai daftar nilai parameter. Misalnya, parameter alamat dapat memiliki nilai sebagai [{parameter: [{name: city, value: abc}]}]

object (NestedParameter)

Parameter value

string

Nama parameter.

string

Nilai parameter dalam string.

string

Nilai string parameter.

string (int64 format)

Nilai bilangan bulat parameter.

string (int64 format)

Nilai bilangan bulat parameter.

boolean

Nilai boolean parameter.

object

activity.list objek messageValue.

object (NestedParameter)

Parameter value

object

ID unik untuk setiap catatan aktivitas.

string

Waktu terjadinya aktivitas. Ini adalah waktu epoch UNIX dalam hitungan detik.

string (int64 format)

Penentu unik jika beberapa peristiwa memiliki waktu yang sama.

string

Nama aplikasi yang mencakup peristiwa tersebut. Untuk kemungkinan nilai, lihat daftar aplikasi di atas di applicationName.

string

ID unik untuk akun Google Workspace.

object

Pengguna melakukan tindakan.

string

ID profil Google Workspace unik pelaku. Nilai ini mungkin tidak ada jika pelaku bukan pengguna Google Workspace, atau mungkin nomor 105250506097979753968 yang bertindak sebagai ID placeholder.

string

Alamat email utama pelaku. Mungkin tidak ada jika tidak ada alamat email yang terkait dengan pelaku.

string

Jenis aktor.

string

Hanya ada saat callerType adalah KEY. Dapat berupa consumer_key pemohon untuk permintaan OAuth 2LO API atau ID untuk akun robot.