Directory API adalah bagian dari RESTful Admin SDK API yang dapat digunakan untuk membuat dan mengelola resource yang dikontrol admin secara terprogram, yang dimiliki oleh Akun Google Workspace Anda. 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 menindaklanjuti data yang hilang perangkat.
- Mengelola bagan dan struktur organisasi Anda.
- Mengaudit aplikasi yang telah diberi akses oleh pengguna Anda dan mencabutnya aplikasi yang tidak diizinkan.
Berikut adalah daftar istilah umum yang digunakan dalam Directory API:
- Pelanggan
- Entitas yang memiliki akun Google Workspace, yang diwakili oleh Referensi pelanggan.
- Domain
- Jika ada, 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 struktur organisasi akun Google Workspace, yang digunakan untuk mengelompokkan dan mengurutkan pengguna untuk menerapkan kebijakan dan memberikan otorisasi baru. OU direpresentasikan oleh OrgUnit.
- Hak istimewa
- Kemampuan pengguna untuk melakukan tindakan pada resource Google Workspace. Berlaku terutama untuk admin. Hak istimewa direpresentasikan oleh Hak istimewa resource Anda.
- Jabatan
- Kumpulan hak istimewa yang telah ditetapkan yang dapat ditetapkan kepada pengguna atau sekelompok pengguna, diwakili oleh Referensi peran.
- Penetapan peran
- Data yang menunjukkan pengguna mana yang diberi peran apa, dan cakupan peran apa yang diberikan. Penetapan peran diwakili oleh RoleAssignment resource Anda.
- Skema
- Objek JSON yang menentukan atribut pengguna khusus untuk organisasi Anda, yang diwakili oleh Resource Schema.
- Pengguna
- Akun pengguna akhir perorangan dengan akses ke aplikasi Google Workspace dan resource, yang diwakili oleh Referensi pengguna.
Langkah berikutnya
Untuk mempelajari cara mengembangkan aplikasi dengan Google Workspace API, termasuk menangani otentikasi dan otorisasi, lihat Mulai sebagai developer Workspace.
Untuk mempelajari cara mengonfigurasi dan menjalankan aplikasi Directory API sederhana, coba Panduan memulai JavaScript.