Objek yang digunakan untuk menentukan apakah pengguna perlu memberikan otorisasi pada skrip ini untuk menggunakan satu atau beberapa layanan, dan memberikan URL untuk dialog otorisasi. Jika skrip dipublikasikan sebagai add-on yang menggunakan pemicu yang dapat diinstal, informasi ini dapat digunakan untuk mengontrol akses ke bagian kode yang otorisasinya tidak diperlukan pengguna. Atau, add-on dapat meminta pengguna membuka URL untuk dialog otorisasi guna menyelesaikan masalah.
Objek ini ditampilkan oleh ScriptApp.getAuthorizationInfo(authMode)
. Dalam hampir
semua kasus, skrip harus memanggil ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL)
,
karena tidak ada mode otorisasi lain yang mewajibkan pengguna memberikan otorisasi.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getAuthorizationStatus() | AuthorizationStatus | Mendapatkan nilai yang menunjukkan apakah pengguna perlu mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan (misalnya, ScriptApp.AuthorizationStatus.REQUIRED ). |
getAuthorizationUrl() | String | Mendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip. |
Dokumentasi mendetail
getAuthorizationStatus()
Mendapatkan nilai yang menunjukkan apakah pengguna perlu mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan (misalnya, ScriptApp.AuthorizationStatus.REQUIRED
).
// Log the authorization status (REQUIRED or NOT_REQUIRED). var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationStatus());
Return
AuthorizationStatus
— status otorisasi
getAuthorizationUrl()
Mendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip. Metode ini menampilkan
null
jika tidak diperlukan otorisasi. Halaman di URL akan otomatis ditutup jika
diakses dan skrip tidak memerlukan otorisasi apa pun.
// Log the URL used to grant access to the script. var authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL); Logger.log(authInfo.getAuthorizationUrl());
Return
String
— URL yang dapat digunakan untuk mengizinkan skrip