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 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 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. Berikut adalah beberapa contoh laporan aktivitas, yang tercantum 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 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 bisa mendapatkan 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 saat 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 berdasarkan 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 tertentu. Informasi penggunaan ini diatur berdasarkan jenis aplikasi dan berisi informasi khusus untuk aplikasi tersebut.
- Laporan penggunaan entitas mencantumkan aktivitas yang terkait dengan entitas yang digunakan oleh pengguna akun Anda di aplikasi Currents.
- Notifikasi
- Reports API memberikan notifikasi yang memungkinkan Anda memantau peristiwa, seperti perubahan pada resource. Saat Anda memantau resource dan resource tersebut berubah, Reports API akan mengirimkan notifikasi kepada Anda. Untuk informasi selengkapnya tentang cara 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 tercantum berdasarkan bahasa pemrograman di menu navigasi sebelah kiri. Anda juga dapat melanjutkan ke bagian ini untuk membaca informasi umum tentang penyiapan 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 informasi selengkapnya, lihat pelacak masalah Admin SDK API, blog Google Workspace Developers, dan pusat bantuan Google Workspace Admin.