Reports API adalah RESTful API yang dapat Anda gunakan untuk mengakses informasi tentang aktivitas Google Workspace pengguna. 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 berdasarkan pengguna.
Berikut adalah daftar istilah umum yang digunakan dalam 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 frekuensi administrator mengubah nama pengguna menggunakan konsol Admin.
- Laporan aktivitas Google Drive mencantumkan cara pengguna domain 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 semua login untuk domain Anda selama jangka waktu tertentu.
- Laporan aktivitas seluler menampilkan aktivitas menggunakan perangkat seluler yang dikelola oleh Pengelolaan Seluler Google. Misalnya, Anda bisa mendapatkan notifikasi saat pengguna mendaftarkan perangkat baru.
- Laporan aktivitas Token OAuth mencantumkan peristiwa ketika pengguna Anda 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 oleh pengguna akun Anda. Laporan ini dapat disesuaikan dan difilter untuk informasi penggunaan yang spesifik. 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 mengirimkan 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 melihatnya berfungsi, gunakan Panduan Memulai, yang dicantumkan berdasarkan bahasa pemrograman di menu navigasi kiri. Anda juga dapat melanjutkan bagian ini untuk membaca informasi umum tentang penyiapan akun.
Untuk menggunakan Reports API, ikuti langkah-langkah prasyarat untuk menyiapkan akun Anda dan menjadi administrator. Anda juga akan membuat project dan mendaftarkannya menggunakan Konsol API Google, dan Anda akan mengaktifkan layanan Reports API.
Bagian otorisasi menunjukkan cara menggunakan token akses OAuth 2.0 untuk memperoleh data pengguna dari aplikasi dan layanan Google Workspace.
Untuk menemukan detail jenis atau metode resource tertentu, baca Referensi API.
Untuk mengetahui informasi selengkapnya, lihat Issue tracker Admin SDK API, blog Developer Google Workspace, dan pusat bantuan Admin Google Workspace.