Ringkasan Reports API

Reports API adalah RESTful API yang dapat digunakan untuk mengakses informasi tentang aktivitas Google Workspace pengguna Anda. Reports API adalah bagian dari Admin SDK API.

Reports API menyediakan dua jenis laporan:

  • Laporan Aktivitas, yang melaporkan peristiwa untuk aplikasi atau layanan tertentu, seperti Google Drive atau konsol Admin.
  • Laporan Penggunaan, yang mencantumkan peristiwa ruang kerja yang disebabkan oleh pengguna.
    • Laporan penggunaan Pelanggan mencantumkan peristiwa untuk semua pengguna di domain Anda.
    • Laporan penggunaan Pengguna mencantumkan peristiwa yang diatur oleh pengguna.

Berikut adalah daftar istilah umum yang digunakan di Reports API:

Laporan aktivitas

Laporan aktivitas mencantumkan informasi untuk aktivitas di aplikasi atau layanan Google Workspace tertentu. Laporan aktivitas mencakup tanggal, waktu, pengguna, dan jenis aktivitas. Referensi API berisi daftar lengkap laporan aktivitas dan informasi yang disertakan di dalamnya. Berikut beberapa contoh laporan aktivitas, yang dicantumkan menurut aplikasi atau layanan:

  • Laporan aktivitas admin menampilkan aktivitas yang dilakukan oleh administrator menggunakan konsol Admin. Misalnya, Anda bisa mendapatkan daftar berapa kali administrator mengubah nama pengguna menggunakan konsol Admin.
  • Laporan aktivitas Google Drive mencantumkan cara pengguna domain Anda mengedit dan melihat dokumen Drive mereka. Misalnya, Anda bisa mendapatkan daftar aktivitas pengguna tertentu di Drive.
  • Laporan aktivitas login memberikan informasi tentang kapan pengguna akun Anda login dan logout dari akun mereka. Misalnya, Anda dapat memperoleh laporan tentang semua login untuk domain Anda selama jangka waktu tertentu.
  • Laporan aktivitas seluler menampilkan aktivitas menggunakan perangkat seluler yang dikelola oleh Pengelolaan Google Seluler. Misalnya, Anda bisa mendapatkan notifikasi saat pengguna mendaftarkan perangkat baru.
  • Laporan aktivitas Token OAuth mencantumkan peristiwa saat pengguna telah memberikan atau mencabut token otorisasi yang digunakan oleh situs dan aplikasi pihak ketiga. Anda dapat menggunakan Reports API untuk mendapatkan daftar semua akses pihak ketiga ke data Google Workspace pengguna.
Laporan penggunaan

Laporan penggunaan memberikan informasi tentang peristiwa Google Workspace di domain Anda. Anda dapat menggunakan API untuk meminta informasi spesifik tentang pengguna.

  • Laporan penggunaan pelanggan mencantumkan aktivitas aplikasi dan layanan yang mendetail di akun Anda. Informasi penggunaan ini diatur menurut jenis aplikasi dan berisi informasi khusus untuk aplikasi tersebut.
  • Laporan penggunaan pengguna menampilkan aktivitas pengguna akun Anda. Laporan ini dapat disesuaikan dan difilter untuk informasi penggunaan tertentu. Informasi penggunaan ini diatur menurut jenis aplikasi dan berisi informasi khusus untuk aplikasi tersebut.
  • Laporan penggunaan entitas mencantumkan aktivitas terkait entitas yang digunakan oleh pengguna akun Anda di aplikasi Currents.
Notifikasi
Reports API menyediakan notifikasi yang memungkinkan Anda memantau peristiwa, seperti perubahan pada resource. Saat Anda melihat resource dan resource tersebut berubah, Reports API akan mengirimi Anda notifikasi. Untuk informasi selengkapnya tentang menyiapkan dan menerima notifikasi dari Reports API, lihat panduan untuk Menerima Notifikasi Push.

Langkah berikutnya

  • Untuk mempelajari Reports API dan melihat cara kerjanya, gunakan Panduan Memulai, yang dicantumkan menurut bahasa pemrograman di menu navigasi kiri. Anda juga dapat melanjutkan bagian ini untuk membaca informasi umum tentang cara menyiapkan akun.

  • Bagian otorisasi menunjukkan cara menggunakan token akses OAuth 2.0 untuk mendapatkan data pengguna dari aplikasi dan layanan Google Workspace.

  • Untuk menemukan detail jenis atau metode resource tertentu, lihat referensi API.

  • Untuk mengetahui informasi selengkapnya, lihat Issue tracker Admin SDK API, blog Developer Google Workspace, dan pusat bantuan Admin Google Workspace.