Directory API adalah bagian dari RESTful Admin SDK API yang dapat digunakan untuk membuat dan mengelola resource yang dikontrol admin secara terprogram dan dimiliki oleh akun Google Workspace. Beberapa kasus penggunaan meliputi:
- Membuat dan mengelola pengguna serta menambahkan administrator.
- Membuat dan mengelola grup dan keanggotaan grup.
- Memantau perangkat yang terhubung ke domain Anda dan mengambil tindakan pada perangkat yang hilang.
- Mengelola bagan dan struktur organisasi Anda.
- Mengaudit aplikasi yang telah diberi akses oleh pengguna Anda dan mencabut aplikasi yang tidak diizinkan.
Berikut adalah daftar istilah umum yang digunakan dalam Directory API:
- Pelanggan
- Entitas yang memiliki akun Google Workspace, yang diwakili oleh resource Pelanggan.
- Domain
- Jika relevan, domain DNS yang terkait dengan akun Google Workspace, yang diwakili oleh resource Domain. Tidak semua akun memiliki domain terkait.
- Unit organisasi (OU)
- Sub-unit dari hierarki organisasi akun Google Workspace, yang digunakan untuk mengelompokkan dan mengurutkan pengguna untuk menerapkan kebijakan serta memberikan otorisasi. OU direpresentasikan oleh resource OrgUnit.
- Hak istimewa
- Kemampuan pengguna untuk melakukan tindakan pada resource Google Workspace. Berlaku terutama untuk admin. Hak istimewa ditunjukkan oleh resource Hak Istimewa.
- Role
- Kumpulan hak istimewa yang ditentukan yang dapat ditetapkan kepada pengguna atau sekelompok pengguna, yang diwakili oleh resource Peran.
- Penetapan peran
- Data yang menunjukkan pengguna mana yang diberi peran apa, dan cakupan peran apa yang diberikan. Penetapan peran direpresentasikan oleh resource RoleAssignment.
- Skema
- Objek JSON yang menentukan atribut pengguna khusus untuk organisasi Anda, yang diwakili oleh resource Skema.
- User
- Akun pengguna akhir perorangan dengan akses ke aplikasi dan resource Google Workspace, yang diwakili oleh resource Pengguna.
Langkah berikutnya
Untuk mempelajari cara mengembangkan aplikasi dengan Google Workspace API, termasuk menangani autentikasi dan otorisasi, lihat Memulai sebagai developer Workspace.
Untuk mempelajari cara mengonfigurasi dan menjalankan aplikasi Directory API sederhana, coba panduan memulai JavaScript.