Memilih cakupan Google Docs API

Dokumen ini berisi informasi otorisasi dan autentikasi khusus API Google Docs. 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 Docs 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.

Jika memungkinkan, sebaiknya gunakan cakupan yang tidak bersifat sensitif karena akan memberikan cakupan akses per file dan mempersempit akses ke fitur tertentu yang dibutuhkan aplikasi.

Docs API mendukung cakupan berikut:

Kode cakupan Deskripsi Penggunaan
https://www.googleapis.com/auth/documents Melihat, mengedit, membuat, dan menghapus semua dokumen Google Dokumen Anda. Sensitif
https://www.googleapis.com/auth/documents.readonly Melihat semua dokumen Google Dokumen Anda. Sensitif
https://www.googleapis.com/auth/drive.file Hanya melihat, mengedit, membuat, dan menghapus file Google Drive tertentu yang Anda gunakan dengan aplikasi ini. Direkomendasikan
Tidak sensitif
https://www.googleapis.com/auth/drive Melihat, mengedit, membuat, dan menghapus semua file Google Drive Anda. Dibatasi
https://www.googleapis.com/auth/drive.readonly Melihat dan mendownload semua file Google Drive Anda. Dibatasi

Kolom Usage dalam tabel menunjukkan sensitivitas setiap cakupan, berdasarkan definisi berikut:

  • Tidak sensitif: Cakupan ini memberikan cakupan akses otorisasi terkecil dan hanya memerlukan verifikasi aplikasi dasar. Untuk mengetahui informasi tentang persyaratan ini, lihat Mengirimkan aplikasi Anda untuk diverifikasi.

  • Sensitif: Cakupan ini memberikan akses ke Data Pengguna Google tertentu yang diizinkan oleh pengguna untuk aplikasi Anda. Cakupan ini mengharuskan Anda melakukan verifikasi aplikasi tambahan. Untuk informasi tentang persyaratan ini, lihat Persyaratan Cakupan Sensitif dan Dibatasi.

  • Dibatasi: Cakupan ini memberikan akses yang luas ke Data Pengguna Google dan mengharuskan Anda melalui proses verifikasi cakupan yang dibatasi. Untuk mengetahui informasi tentang persyaratan ini, lihat Kebijakan Data Pengguna Layanan Google API dan Persyaratan Tambahan untuk Cakupan API Tertentu. Jika Anda menyimpan data cakupan yang dibatasi di server (atau mentransmisikan), Anda harus melalui penilaian keamanan.

Jika aplikasi Anda memerlukan akses ke Google API lainnya, Anda juga dapat menambahkan cakupan tersebut. Untuk informasi selengkapnya tentang cakupan Google API, lihat Menggunakan OAuth 2.0 untuk Mengakses Google API.

Untuk informasi selengkapnya tentang cakupan OAuth 2.0 tertentu, lihat Cakupan OAuth 2.0 untuk Google API.