Memilih cakupan Directory API

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.