Directory API adalah bagian dari RESTful Admin SDK API yang dapat digunakan untuk membuat dan mengelola resource yang dikontrol admin yang dimiliki oleh akun Google Workspace secara terprogram. Beberapa kasus penggunaan mencakup:
- Membuat dan mengelola pengguna serta menambahkan administrator.
- Membuat serta mengelola grup dan keanggotaan grup.
- Memantau perangkat yang terhubung ke domain Anda dan mengambil tindakan terhadap perangkat yang hilang.
- Mengelola struktur organisasi dan diagram organisasi Anda.
- Mengaudit aplikasi yang telah diberi akses oleh pengguna ke dan mencabut aplikasi yang tidak diizinkan.
Berikut adalah daftar istilah umum yang digunakan di Directory API:
- Pelanggan
- Entitas yang memiliki akun Google Workspace, diwakili oleh resource Pelanggan.
- Domain
- Jika berlaku, domain DNS yang terkait dengan akun Google Workspace, yang diwakili oleh resource Domain. Tidak semua akun memiliki domain terkait.
- Unit organisasi (OU)
- Subunit hierarki organisasi akun Google Workspace, yang digunakan untuk mengelompokkan dan mengurutkan pengguna untuk tujuan penerapan kebijakan dan pemberian otorisasi. OU diwakili oleh resource OrgUnit.
- Hak istimewa
- Kemampuan pengguna untuk melakukan tindakan pada resource Google Workspace. Berlaku terutama untuk admin. Hak istimewa diwakili oleh resource Hak istimewa.
- Peran
- Kumpulan hak istimewa yang ditentukan yang dapat ditetapkan kepada pengguna atau serangkaian pengguna, yang diwakili oleh resource Role.
- Penetapan peran
- Data yang menunjukkan pengguna mana yang diberi peran apa, dan cakupannya. Penetapan peran direpresentasikan oleh resource RoleAssignment.
- Skema
- Objek JSON yang menentukan atribut pengguna khusus untuk organisasi Anda, yang direpresentasikan oleh resource Skema.
- Pengguna
- Akun pengguna akhir individual dengan akses ke aplikasi dan resource Google Workspace, yang diwakili oleh resource Pengguna.
Langkah berikutnya
Untuk mempelajari cara mengembangkan 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.