Pilih cakupan Google Drive Labels API

Dokumen ini berisi informasi autentikasi dan otorisasi khusus Drive Labels API. Sebelum membaca dokumen ini, pastikan Anda telah membaca informasi autentikasi dan otorisasi umum 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 Anda agar 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 tingkat aksesnya. 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 yang difokuskan dan menghindari permintaan cakupan yang tidak diperlukan aplikasi. Pengguna lebih mudah memberikan akses ke cakupan yang terbatas dan dijelaskan dengan jelas.

Jika memungkinkan, sebaiknya gunakan cakupan tidak sensitif karena akan memberikan cakupan akses per file dan mempersempit akses ke fungsi tertentu yang diperlukan oleh aplikasi.

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

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

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 diotorisasi untuk aplikasi.

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

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 jika 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 jika 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 yang terkait dengan label organisasi Anda. Cakupan ini memungkinkan akses admin dan diperlukan untuk operasi tulis jika 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 yang terkait dengan label di organisasi Anda. Cakupan ini memungkinkan akses admin dan diperlukan untuk operasi baca jika 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 dengan hak istimewa Mengelola Label.

useAdminAccess

Administrator harus menetapkan parameter useAdminAccess untuk memanggil hak istimewa admin mereka. Jika useAdminAccess ditetapkan, label apa pun yang dimiliki oleh pelanggan dapat dilihat dan diedit. 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 mengetahui informasi selengkapnya, lihat Membuat kredensial akses.