Reports API adalah RESTful API yang dapat Anda gunakan 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 IT mereka, 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 di Reports API:
- Laporan aktivitas
Laporan aktivitas mencantumkan informasi untuk aktivitas di Google Workspace tertentu aplikasi atau layanan tertentu. Laporan aktivitas mencakup tanggal, waktu, pengguna, dan jenis aktivitas Anda. Tujuan Referensi API berisi daftar lengkap laporan aktivitas dan informasi yang disertakan. Berikut adalah 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 semua waktu administrator mengubah nama pengguna menggunakan konsol Admin.
- Laporan aktivitas Google Drive menampilkan daftar cara pengguna domain Anda mengedit dan melihat dokumen Drive mereka. Sebagai misalnya, Anda bisa mendapatkan daftar aktivitas pengguna tertentu di Drive.
- Laporan aktivitas login memberikan informasi tentang kapan pengguna akun Anda masuk dan keluar dari menggunakan akun layanan. Misalnya, Anda bisa mendapatkan laporan tentang semua login untuk selama jangka waktu tertentu.
- Laporan aktivitas seluler tampilkan aktivitas menggunakan perangkat seluler yang dikelola oleh Google Pengelolaan 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 terperinci di akun Anda. Penggunaan ini informasi diatur menurut jenis aplikasi dan berisi informasi yang spesifik untuk aplikasi tersebut.
- Laporan penggunaan pengguna menampilkan aktivitas oleh 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 entity buat daftar aktivitas yang terkait dengan 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 sumber daya dan sumber daya itu berubah, Reports API akan mengirimkan notifikasi. Untuk informasi lebih lanjut tentang pengaturan 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 oleh bahasa pemrograman di bilah navigasi kiri. Anda dapat juga melanjutkan bagian ini untuk membaca informasi umum tentang menyiapkan akun Anda.
Tujuan 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 informasi selengkapnya, lihat Issue tracker Admin SDK API, tindakan Blog Developer Google Workspace, dan Pusat bantuan Admin Google Workspace.