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). Dalam hampir semua kasus, skrip harus memanggil ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), karena tidak ada mode otorisasi lain yang mengharuskan pengguna memberikan otorisasi.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getAuthorizationStatus()AuthorizationStatusMendapatkan nilai yang menunjukkan apakah pengguna perlu memberikan otorisasi pada skrip ini untuk menggunakan satu atau beberapa layanan (misalnya, ScriptApp.AuthorizationStatus.REQUIRED).
getAuthorizationUrl()StringMendapatkan URL otorisasi yang dapat digunakan untuk memberikan akses ke skrip.
getAuthorizedScopes()String[]Mendapatkan daftar cakupan yang diotorisasi untuk skrip.

Dokumentasi mendetail

getAuthorizationStatus()

Mendapatkan nilai yang menunjukkan apakah pengguna perlu memberikan otorisasi pada 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 menampilkan null jika tidak ada otorisasi yang diperlukan. 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.
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationUrl());

Pulang pergi

String — URL yang dapat digunakan untuk memberikan otorisasi pada skrip

getAuthorizedScopes()

Mendapatkan daftar cakupan yang diotorisasi untuk skrip. Jika informasi otorisasi diminta untuk daftar cakupan yang ditentukan, tampilkan 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[] — Daftar cakupan yang diotorisasi.