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 mencakup:
- Membuat dan mengelola pengguna serta menambahkan administrator.
- Membuat dan mengelola grup serta keanggotaan grup.
- Memantau perangkat yang terhubung ke domain Anda dan mengambil tindakan pada perangkat yang hilang.
- Mengelola struktur organisasi dan bagan organisasi Anda.
- Mengaudit aplikasi yang telah diberi akses oleh pengguna dan mencabut aplikasi yang tidak sah.
Berikut adalah daftar istilah umum yang digunakan di Directory API:
- Pelanggan
- Entitas yang memiliki akun Google Workspace, yang diwakili oleh resource Pelanggan.
- Domain
- Jika berlaku, domain DNS yang terkait dengan akun Google Workspace, 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 diwakili 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.
- Jabatan
- Kumpulan hak istimewa yang ditentukan yang dapat ditetapkan ke pengguna atau kumpulan pengguna, yang diwakili oleh resource Peran.
- Penetapan peran
- Data yang menunjukkan pengguna mana yang diberi peran apa, dan dalam cakupan apa. Penetapan peran diwakili oleh resource RoleAssignment.
- Skema
- Objek JSON yang menentukan atribut pengguna kustom untuk organisasi Anda, yang diwakili oleh resource Skema.
- Pengguna
- Akun pengguna akhir perorangan 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.