Class AuthorizationInfo

Thông tinuỷ quyền

Một đối tượng kiểm tra xem người dùng đã cấp quyền cho các phạm vi bắt buộc của tập lệnh hay chưa. Đối tượng này cũng cung cấp một URL uỷ quyền để người dùng cấp các quyền đó.

Một số hoạt động thực thi tập lệnh có thể bắt đầu mà không cần người dùng đồng ý với tất cả các phạm vi bắt buộc mà tập lệnh sử dụng. Thông tin trong đối tượng này cho phép bạn kiểm soát quyền truy cập vào các phần mã yêu cầu một số phạm vi nhất định và yêu cầu uỷ quyền các phạm vi đó cho các lần thực thi tiếp theo.

Đối tượng này được ScriptApp.getAuthorizationInfo(authMode) trả về. Trong hầu hết các trường hợp, tập lệnh sẽ gọi ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL), vì không có chế độ uỷ quyền nào khác yêu cầu người dùng cấp quyền uỷ quyền.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getAuthorizationStatus()AuthorizationStatusLấy một giá trị cho biết người dùng có cần cấp quyền cho tập lệnh này để sử dụng một hoặc nhiều dịch vụ (ví dụ: ScriptApp.AuthorizationStatus.REQUIRED) hay không.
getAuthorizationUrl()String|nullLấy URL uỷ quyền có thể dùng để cấp quyền truy cập vào tập lệnh.
getAuthorizedScopes()String[]|nullLấy danh sách các phạm vi được uỷ quyền cho tập lệnh.

Tài liệu chi tiết

getAuthorizationStatus()

Lấy một giá trị cho biết người dùng có cần cấp quyền cho tập lệnh này để sử dụng một hoặc nhiều dịch vụ (ví dụ: ScriptApp.AuthorizationStatus.REQUIRED) hay không. 

// Log the authorization status (REQUIRED or NOT_REQUIRED).
const authInfo = ScriptApp.getAuthorizationInfo(ScriptApp.AuthMode.FULL);
Logger.log(authInfo.getAuthorizationStatus());

Cầu thủ trả bóng

AuthorizationStatus – trạng thái uỷ quyền

getAuthorizationUrl()

Lấy URL uỷ quyền có thể dùng để cấp quyền truy cập vào tập lệnh. Phương thức này trả về null nếu không cần có giấy uỷ quyền. Trang tại URL sẽ tự động đóng nếu được truy cập và tập lệnh không yêu cầu bất kỳ uỷ quyền nào. 

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

Cầu thủ trả bóng

String|null – một URL có thể dùng để uỷ quyền cho tập lệnh

getAuthorizedScopes()

Lấy danh sách các phạm vi được uỷ quyền cho tập lệnh. Nếu thông tin uỷ quyền được yêu cầu cho một danh sách phạm vi cụ thể, hãy trả về các phạm vi được uỷ quyền trong danh sách cụ thể đó. 

// 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());

Cầu thủ trả bóng

String[]|null – Danh sách các phạm vi được uỷ quyền.