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 menurut 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 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 setiap 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 bisa mendapatkan laporan 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 oleh pelanggan mencantumkan aktivitas mendetail dan aplikasi 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 tertentu. Informasi penggunaan ini disusun 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 menonton peristiwa, seperti perubahan pada resource. Saat Anda mengamati resource dan resource tersebut berubah, Reports API mengirimi Anda notifikasi. Untuk mengetahui informasi selengkapnya tentang cara menyiapkan dan menerima notifikasi dari Reports API, lihat panduan untuk Menerima Notifikasi Push.
Langkah berikutnya
Untuk mempelajari API Laporan dan melihatnya berfungsi, gunakan Panduan Memulai, yang dicantumkan menurut bahasa pemrograman di menu navigasi sebelah kiri. Anda juga dapat melanjutkan bagian ini untuk membaca informasi umum tentang penyiapan akun Anda.
Untuk menggunakan Reports API, ikuti langkah-langkah prasyarat untuk menyiapkan akun dan menjadi administrator. Anda juga akan membuat project dan mendaftarkannya menggunakan Konsol API Google, dan akan mengaktifkan layanan Reports API.
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.