Ringkasan Reports API
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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 disusun 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.
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 dapat memperoleh daftar semua waktu saat 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
Google Pengelolaan Seluler.
Misalnya, Anda dapat menerima 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 disusun berdasarkan 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 disusun
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 menyediakan 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 mengetahui informasi selengkapnya tentang cara menyiapkan dan menerima notifikasi dari Reports API, lihat panduan Menerima Notifikasi Push.
Langkah berikutnya
Untuk mempelajari Reports API dan melihat cara kerjanya, gunakan Panduan memulai,
yang tercantum menurut bahasa pemrograman di panel navigasi kiri. Anda juga dapat melanjutkan bagian ini untuk membaca informasi umum tentang penyiapan akun Anda.
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
pelacak masalah Admin SDK API,
blog Developer Google Workspace,
dan
pusat bantuan Admin Google Workspace.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-29 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-29 UTC."],[],[],null,["# Reports API Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]
