Pilih cakupan Google Drive Labels API

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

Mengonfigurasi OAuth 2.0 untuk otorisasi

Mengonfigurasi layar izin OAuth dan memilih cakupan untuk menentukan informasi yang akan ditampilkan kepada pengguna dan peninjau aplikasi, dan mendaftarkan aplikasi Anda sehingga Anda dapat memublikasikannya nanti.

Cakupan Google Drive Labels 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 level akses. Cakupan adalah permintaan aplikasi Anda untuk bekerja dengan data Google Workspace, termasuk pengguna data Akun Google.

Saat aplikasi Anda diinstal, pengguna akan diminta untuk memvalidasi cakupan yang digunakan oleh aplikasi. Umumnya, Anda harus memilih ruang lingkup dengan fokus yang paling sempit mungkin dan menghindari permintaan cakupan yang tidak diperlukan aplikasi Anda. Pengguna lainnya langsung memberikan akses ke cakupan yang terbatas dan dijelaskan dengan jelas.

Jika memungkinkan, sebaiknya gunakan cakupan yang tidak sensitif karena cakupan tersebut memberikan per file mengakses ruang lingkup dan mempersempit akses ke fungsionalitas tertentu yang dibutuhkan oleh aplikasi.

Jika aplikasi publik Anda menggunakan cakupan yang mengizinkan akses ke data pengguna tertentu, maka proses verifikasi harus diselesaikan. Jika Anda melihat belum terverifikasi aplikasi di layar saat menguji aplikasi, Anda harus mengirimkan permintaan verifikasi untuk menghapusnya. Cari tahu selengkapnya tentang aplikasi belum diverifikasi dan dapatkan jawaban untuk pertanyaan umum (FAQ) tentang verifikasi aplikasi di Pusat Bantuan.

Cakupan OAuth 2.0 berikut dapat digunakan untuk membaca, menelusuri, dan mengubah label metadata diterapkan untuk item Drive:

Cakupan	Arti
https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.metadata	Membaca, menelusuri, dan mengubah metadata label yang diterapkan ke item Drive.
https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly	Membaca dan menelusuri metadata label yang diterapkan ke item Drive yang diberi otorisasi untuk aplikasi.

Untuk informasi selengkapnya, lihat OAuth 2.0 Drive API Cakupan dan khusus API Drive otorisasi.

Cakupan untuk label

Cakupan OAuth berikut dapat digunakan untuk melihat dan mengelola label:

Cakupan	Arti
https://www.googleapis.com/auth/drive.labels	Melihat, menggunakan, dan mengelola label Drive. Cakupan ini memungkinkan akses pengguna, dan diperlukan untuk operasi tulis saat use_admin_access tidak ditetapkan. Operasi tulis dengan cakupan ini valid untuk label dengan jenis label SHARED.
https://www.googleapis.com/auth/drive.labels.readonly	Melihat dan menggunakan label Drive. Cakupan ini memungkinkan akses pengguna, dan diperlukan untuk operasi baca saat use_admin_access tidak ditetapkan.
https://www.googleapis.com/auth/drive.admin.labels	Melihat, mengedit, membuat, dan menghapus semua label Drive di organisasi Anda, serta melihat kebijakan administrasi terkait label organisasi Anda. Cakupan ini memungkinkan akses admin, dan diperlukan untuk operasi tulis saat use_admin_access ditetapkan. Cakupan ini juga memberikan akses baca. Operasi tulis dengan cakupan ini valid untuk label dengan jenis label SHARED atau ADMIN.
https://www.googleapis.com/auth/drive.admin.labels.readonly	Melihat semua label Drive dan kebijakan administrasi terkait label di organisasi Anda. Cakupan ini memungkinkan akses admin, dan diperlukan untuk operasi baca saat use_admin_access ditetapkan.

Akses administrator

Catatan: EDITOR LabelRole tidak dapat digunakan dengan label ADMIN. Hak istimewa administrator diperlukan untuk mengelola label ADMIN.

Untuk mengelola label ADMIN, Anda harus menentukan:

• useAdminAccess adalah true untuk menggunakan kredensial administrator pengguna.
• Administrator akun yang memiliki kemampuan Kelola Label istimewa tersebut.

useAdminAccess

Administrator harus menetapkan parameter useAdminAccess untuk memanggil admin mereka hak istimewa pengguna. Menyetel useAdminAccess memungkinkan tampilan dan pengeditan label apa pun dimiliki oleh pelanggan. Ini mencakup Label ADMIN dan SHARED.

Jika useAdminAccess tidak ditetapkan, permintaan tulis hanya diizinkan untuk label dengan SHARED label type dan untuk pengguna dengan peran EDITOR yang sesuai untuk label ini.

Untuk informasi selengkapnya, lihat Membuat akses kredensial.