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 bagan organisasi dan struktur organisasi Anda.
- Mengaudit aplikasi yang telah diberi akses oleh pengguna dan mencabut aplikasi yang tidak diizinkan.
Berikut adalah daftar istilah umum yang digunakan dalam 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)
- Sub-unit dari hierarki organisasi akun Google Workspace, yang digunakan untuk mengelompokkan dan mengurutkan pengguna untuk tujuan penerapan kebijakan dan otorisasi. OU direpresentasikan oleh resource OrgUnit.
- Hak Istimewa
- Kemampuan pengguna untuk melakukan tindakan di referensi Google Workspace. Berlaku terutama untuk admin. Hak istimewa direpresentasikan oleh resource Hak Istimewa.
- Role
- Kumpulan hak istimewa yang telah ditentukan yang dapat ditetapkan kepada satu pengguna atau sekelompok pengguna, yang direpresentasikan oleh resource Peran.
- Penetapan peran
- Data yang menunjukkan pengguna mana yang diberi peran dan cakupannya. Penetapan peran direpresentasikan oleh resource RoleAssignment.
- Skema
- Objek JSON yang menentukan atribut pengguna khusus untuk organisasi Anda, yang diwakili oleh resource Skema.
- Pengguna
- Akun pengguna akhir perorangan dengan akses ke resource dan aplikasi 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.