Pilih cakupan Google Drive Labels API

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

Mengonfigurasi OAuth 2.0 untuk otorisasi

Konfigurasi layar izin OAuth dan pilih cakupan untuk menentukan informasi yang ditampilkan kepada pengguna dan peninjau aplikasi, serta daftarkan aplikasi Anda agar dapat dipublikasikan nanti.

Cakupan Google Drive Labels API

Untuk menentukan tingkat akses yang diberikan ke aplikasi Anda, Anda harus 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 dan menghindari permintaan cakupan yang tidak diperlukan aplikasi Anda. Pengguna lebih mudah memberikan akses ke cakupan terbatas yang dijelaskan dengan jelas.

Jika memungkinkan, sebaiknya gunakan cakupan non-sensitif karena cakupan ini 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 Anda melihat aplikasi yang belum diverifikasi di layar saat menguji aplikasi, Anda harus mengirimkan permintaan verifikasi untuk menghapusnya. Pelajari lebih lanjut tentang aplikasi yang belum diverifikasi dan dapatkan jawaban atas pertanyaan umum tentang verifikasi aplikasi di Pusat Bantuan.

Cakupan OAuth 2.0 berikut dapat digunakan untuk membaca, menelusuri, dan mengubah metadata label yang diterapkan pada 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 pada item Drive.
https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.metadata.readonly	Membaca dan menelusuri metadata label yang diterapkan pada item Drive yang diizinkan 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 berlaku untuk label dengan SHARED jenis label.
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 di 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 berlaku untuk label dengan SHARED atau ADMIN jenis label.
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. Menetapkan useAdminAccess memungkinkan melihat dan mengedit label apa pun yang dimiliki oleh pelanggan. Hal 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.