Class AuthorizationInfo

AuthorizationInfo

Objek yang memeriksa apakah pengguna telah memberikan otorisasi untuk cakupan skrip yang diperlukan. Objek ini juga menyediakan URL otorisasi bagi pengguna untuk memberikan izin tersebut.

Beberapa eksekusi skrip dapat dimulai tanpa izin pengguna untuk semua cakupan yang diperlukan yang digunakan oleh skrip. Informasi dalam objek ini memungkinkan Anda mengontrol akses ke bagian kode yang memerlukan cakupan tertentu dan meminta otorisasi cakupan tersebut untuk eksekusi berikutnya.

Objek ini ditampilkan oleh ScriptApp.getAuthorizationInfo(authMode). Hampir di semua kasus, skrip harus memanggil ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), karena tidak ada mode otorisasi lain yang mengharuskan pengguna memberikan otorisasi.

Metode

MetodeJenis nilai yang ditampilkanDeskripsi singkat
getAuthorizationStatus()AuthorizationStatusMendapatkan nilai yang menunjukkan apakah pengguna perlu mengizinkan skrip ini untuk menggunakan satu atau beberapa layanan (misalnya, ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()String|nullMendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip.
getAuthorizedScopes()String[]|nullMendapatkan daftar cakupan yang diizinkan untuk 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).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

Pulang pergi

AuthorizationStatus — Status otorisasi.

getAuthorizationUrl()

Mendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip. Metode ini akan menampilkan null jika tidak ada otorisasi yang diperlukan. Halaman di URL akan ditutup secara otomatis jika diakses dan skrip tidak memerlukan otorisasi apa pun. 

// Log the URL used to grant access to the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

Pulang pergi

String|null — URL yang dapat digunakan untuk mengizinkan skrip.

getAuthorizedScopes()

Mendapatkan daftar cakupan yang diizinkan untuk skrip. Jika informasi otorisasi diminta untuk daftar cakupan tertentu, akan menampilkan cakupan yang diotorisasi dari daftar yang ditentukan. 

// Logs which scopes in the specified list have been authorized for the script.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL, [
  'https: //www.googleapis.com/auth/documents',
  'https: //www.googleapis.com/auth/spreadsheets',
]);
Logger.log(authInfo.getAuthorizedScopes());

Pulang pergi

String[]|null — Daftar cakupan yang diberi otorisasi.