Memilih cakupan Directory API

Dokumen ini berisi informasi otorisasi dan autentikasi khusus Directory API. Sebelum membaca dokumen ini, pastikan Anda membaca informasi autentikasi dan otorisasi umum Google Workspace di Pelajari autentikasi dan otorisasi.

Mengonfigurasi OAuth 2.0 untuk otorisasi

Mengonfigurasi layar izin OAuth dan memilih cakupan untuk menentukan informasi yang ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan 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 diakses, dan tingkat akses. Cakupan adalah permintaan aplikasi Anda untuk menggunakan 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 sempit fokusnya dan menghindari permintaan cakupan yang tidak diperlukan aplikasi Anda. Pengguna lebih mudah memberikan akses ke cakupan terbatas yang dijelaskan dengan jelas.

Jika aplikasi publik Anda menggunakan cakupan yang mengizinkan akses ke data pengguna tertentu, aplikasi tersebut harus menyelesaikan proses verifikasi. Jika Anda melihat aplikasi yang belum diverifikasi di layar saat menguji aplikasi, Anda harus mengirimkan permintaan verifikasi untuk menghapusnya. Cari tahu lebih lanjut tentang aplikasi yang belum diverifikasi dan dapatkan jawaban atas pertanyaan umum tentang verifikasi aplikasi di Pusat Bantuan.

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 untuk tugas yang melakukan 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 operasi sandi spesifik per aplikasi, token OAuth, dan kode verifikasi.
Cakupan untuk pengelolaan peran	Arti
https://www.googleapis.com/auth/admin.directory.rolemanagement	Cakupan untuk semua operasi pengelolaan peran, termasuk membuat 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 untuk hanya mengambil domain.
Cakupan untuk fasilitas kalender	Arti
https://www.googleapis.com/auth/admin.directory.resource.calendar	Cakupan untuk akses ke semua operasi resource kalender.
https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly	Cakupan untuk hanya mengambil fasilitas kalender.