Trang này được dịch bởi Cloud Translation API.

Class AuthorizationInfo

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ố quá trình 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 cho các phạm vi đó cho các lần thực thi tiếp theo.

Đối tượng này do ScriptApp.getAuthorizationInfo(authMode) trả về. Trong hầu hết các trường hợp, tập lệnh phải 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.

Phương thức

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`getAuthorizationStatus()`	`AuthorizationStatus`	Lấy một giá trị cho biết người dùng có cần uỷ quyền cho tập lệnh này sử dụng một hoặc nhiều dịch vụ hay không (ví dụ: `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String`	Lấy URL uỷ quyền có thể dùng để cấp quyền truy cập vào tập lệnh.
`getAuthorizedScopes()`	`String[]`	Lấ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 uỷ quyền cho tập lệnh này sử dụng một hoặc nhiều dịch vụ hay không (ví dụ: ScriptApp.AuthorizationStatus.REQUIRED).

// 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 uỷ quyền. Trang tại URL sẽ tự động đóng nếu người dùng truy cập vào trang đó và tập lệnh không yêu cầu bất kỳ 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 – 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 đã chỉ định.

// 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[] – Danh sách các phạm vi được uỷ quyền.