Dokumen ini berisi informasi autentikasi dan otorisasi khusus Directory API. Sebelum membaca dokumen ini, pastikan Anda membaca informasi autentikasi umum dan otorisasi Google Workspace di artikel Mempelajari autentikasi dan otorisasi.
Mengonfigurasi OAuth 2.0 untuk otorisasi
Konfigurasikan layar izin OAuth dan pilih cakupan untuk menentukan informasi yang ditampilkan kepada pengguna dan peninjau aplikasi, serta daftarkan aplikasi agar Anda dapat memublikasikannya nanti.
Cakupan Directory API
Untuk menentukan tingkat akses yang diberikan ke aplikasi, Anda perlu mengidentifikasi dan mendeklarasikan cakupan otorisasi. Cakupan otorisasi adalah string URI OAuth 2.0 yang berisi nama aplikasi Google Workspace, jenis data yang diaksesnya, dan tingkat akses. Cakupan adalah permintaan aplikasi Anda untuk menangani data Google Workspace, termasuk data Akun Google pengguna.
Saat aplikasi Anda diinstal, pengguna akan diminta untuk memvalidasi cakupan yang digunakan oleh aplikasi. Umumnya, Anda harus memilih cakupan yang paling difokuskan dan menghindari permintaan cakupan yang tidak diperlukan aplikasi. Pengguna dapat lebih mudah memberikan akses ke cakupan yang terbatas dan dijelaskan dengan jelas.
Directory API mendukung cakupan berikut:
| Cakupan untuk perangkat | Arti |
|---|---|
https://www.googleapis.com/auth/admin.directory.device.chromeos |
Cakupan global untuk akses ke semua operasi perangkat Chrome. |
https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly |
Cakupan untuk hanya mengambil perangkat Chrome. |
https://www.googleapis.com/auth/admin.directory.device.mobile |
Cakupan global untuk akses ke semua operasi perangkat seluler. |
https://www.googleapis.com/auth/admin.directory.device.mobile.readonly |
Cakupan untuk hanya mengambil perangkat seluler |
https://www.googleapis.com/auth/admin.directory.device.mobile.action |
Cakupan tugas yang mengambil tindakan di perangkat seluler. |
| Cakupan untuk grup, alias grup, dan anggota grup | Arti |
https://www.googleapis.com/auth/admin.directory.group.member |
Cakupan untuk akses ke semua peran anggota grup dan operasi informasi. |
https://www.googleapis.com/auth/admin.directory.group.member.readonly |
Cakupan untuk hanya mengambil peran dan informasi anggota grup. |
https://www.googleapis.com/auth/admin.directory.group |
Cakupan global untuk akses ke semua operasi grup, termasuk alias dan anggota grup. |
https://www.googleapis.com/auth/admin.directory.group.readonly |
Cakupan untuk hanya mengambil informasi grup, alias grup, dan anggota. |
| Cakupan untuk unit organisasi | Arti |
https://www.googleapis.com/auth/admin.directory.orgunit |
Cakupan global untuk akses ke semua operasi unit organisasi. |
https://www.googleapis.com/auth/admin.directory.orgunit.readonly |
Cakupan untuk hanya mengambil unit organisasi. |
| Cakupan untuk pengguna dan alias pengguna | Arti |
https://www.googleapis.com/auth/admin.directory.user |
Cakupan global untuk akses ke semua operasi alias pengguna dan pengguna. |
https://www.googleapis.com/auth/admin.directory.user.readonly |
Cakupan untuk hanya mengambil pengguna atau alias pengguna. |
https://www.googleapis.com/auth/admin.directory.user.alias |
Cakupan untuk akses ke semua operasi alias pengguna. |
https://www.googleapis.com/auth/admin.directory.user.alias.readonly |
Cakupan untuk hanya mengambil alias pengguna. |
| Cakupan untuk fitur keamanan pengguna | Arti |
https://www.googleapis.com/auth/admin.directory.user.security |
Cakupan untuk akses ke semua sandi spesifik per aplikasi, token OAuth, dan operasi kode verifikasi. |
| Ruang lingkup untuk manajemen peran | Arti |
https://www.googleapis.com/auth/admin.directory.rolemanagement |
Cakupan untuk semua operasi pengelolaan peran, termasuk pembuatan peran dan penetapan peran. |
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly |
Cakupan untuk mendapatkan dan mencantumkan peran, hak istimewa, dan penetapan peran. |
| Cakupan untuk skema pengguna kustom | Arti |
https://www.googleapis.com/auth/admin.directory.userschema |
Cakupan untuk akses ke semua operasi skema pengguna kustom. |
https://www.googleapis.com/auth/admin.directory.userschema.readonly |
Cakupan untuk hanya mengambil skema pengguna kustom. |
| Cakupan untuk pelanggan | Arti |
https://www.googleapis.com/auth/admin.directory.customer |
Cakupan untuk akses ke semua operasi pelanggan. |
https://www.googleapis.com/auth/admin.directory.customer.readonly |
Cakupan untuk hanya mengambil pelanggan. |
| Cakupan untuk domain | Arti |
https://www.googleapis.com/auth/admin.directory.domain |
Cakupan untuk akses ke semua operasi domain. |
https://www.googleapis.com/auth/admin.directory.domain.readonly |
Cakupan hanya untuk mengambil domain. |
| Cakupan untuk fasilitas kalender | Arti |
https://www.googleapis.com/auth/admin.directory.resource.calendar |
Cakupan untuk akses ke semua operasi fasilitas kalender. |
https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly |
Cakupan untuk hanya mengambil resource kalender. |