Apps Script cần có sự cho phép của người dùng để truy cập vào dữ liệu riêng tư từ các dịch vụ tích hợp sẵn của Google hoặc các dịch vụ nâng cao của Google.
Cấp quyền truy cập
Apps Script xác định phạm vi uỷ quyền (như quyền truy cập vào Google Trang tính của bạn hoặc Gmail) dựa trên việc quét mã. Mã bị nhận xét vẫn có thể tạo yêu cầu uỷ quyền. Nếu một tập lệnh cần uỷ quyền, bạn sẽ thấy một trong số các hộp thoại uỷ quyền được hiển thị tại đây khi chạy.
Những tập lệnh mà bạn đã cho phép trước đây cũng yêu cầu cung cấp thêm thông tin uỷ quyền nếu việc thay đổi mã thêm các dịch vụ mới. Tập lệnh không được yêu cầu Nếu bạn truy cập tập lệnh dưới dạng một ứng dụng web chạy trong danh tính người dùng của chủ sở hữu tập lệnh.
Thu hồi quyền truy cập
Để thu hồi quyền truy cập của tập lệnh vào dữ liệu của bạn, hãy làm theo các bước sau:
- Truy cập vào trang permissions cho Tài khoản Google của bạn. (Để điều hướng đến trang này trong tương lai, hãy truy cập vào Google.com, sau đó hãy nhấp vào ảnh tài khoản của bạn ở góc trên cùng bên phải màn hình. Tiếp theo, hãy nhấp vào Tài khoản của tôi, sau đó chọn Ứng dụng được kết nối và các trang web thuộc "Đăng nhập và bảo mật" rồi chọn Quản lý ứng dụng.)
- Nhấp vào tên của tập lệnh có lệnh uỷ quyền mà bạn muốn thu hồi, sau đó nhấp vào Remove (Xoá) ở bên phải, sau đó nhấp vào OK trong hộp thoại thu được.
Quyền và các loại tập lệnh
Danh tính người dùng mà một tập lệnh chạy cùng – và do đó dữ liệu mà tập lệnh có thể truy cập – sẽ khác nhau tuỳ theo tình huống mà tập lệnh chạy, như được trình bày trong bảng bên dưới.
| Loại tập lệnh | Tập lệnh chạy dưới dạng... |
|---|---|
| Độc lập, tiện ích bổ sung, hoặc liên kết với Tài liệu, Trang tính, Trang trình bày hoặc Biểu mẫu | Người dùng tại bàn phím |
| Hàm tuỳ chỉnh trong bảng tính | Người dùng ẩn danh; tuy nhiên, hạn mức tính vào người dùng trên bàn phím |
| Ứng dụng web hoặc Tiện ích Google Sites | Người dùng ở chủ sở hữu bàn phím hoặc tập lệnh, phụ thuộc vào lựa chọn khi triển khai ứng dụng |
| Trình kích hoạt có thể cài đặt | Người dùng đã tạo điều kiện kích hoạt |
Phạm vi uỷ quyền thủ công cho Trang tính, Tài liệu, Trang trình bày và Biểu mẫu
Nếu bạn đang tạo tiện ích bổ sung hoặc tập lệnh khác sử dụng dịch vụ Bảng tính, Dịch vụ tài liệu, Dịch vụ Trang trình bày hoặc Dịch vụ Biểu mẫu, bạn có thể buộc ủy quyền hộp thoại yêu cầu chỉ yêu cầu quyền truy cập vào các tệp có sử dụng tiện ích bổ sung hoặc tập lệnh, thay vì tất cả bảng tính, tài liệu hoặc biểu mẫu của người dùng. Để làm được điều này, hãy thêm chú thích JsDoc sau đây trong nhận xét ở cấp tệp:
/**
* @OnlyCurrentDoc
*/
Chú giải đối lập, @NotOnlyCurrentDoc, sẽ có sẵn nếu tập lệnh của bạn
có một thư viện khai báo
@OnlyCurrentDoc, nhưng tập lệnh chính thực sự yêu cầu quyền truy cập vào hơn
tệp hiện tại.
Vòng đời uỷ quyền của tiện ích bổ sung
Tiện ích bổ sung cho Google Trang tính, Tài liệu, Trang trình bày và Biểu mẫu
thường tuân theo cùng một mô hình uỷ quyền
như tập lệnh
ràng buộc vào một tài liệu. Trong một số
tuy nhiên, các hàm onOpen(e) và onEdit(e) của chúng lại chạy trong
chế độ không cấp quyền. Đây là một số chức năng khác. Để biết thêm
thông tin, hãy xem
hướng dẫn về vòng đời uỷ quyền của tiện ích bổ sung.
Giới hạn về người dùng đối với ứng dụng OAuth
Các ứng dụng dùng OAuth để truy cập vào dữ liệu người dùng Google, bao gồm cả các ứng dụng Các dự án tập lệnh phải tuân theo giới hạn uỷ quyền. Xem Giới hạn về người dùng đối với ứng dụng OAuth để biết thông tin chi tiết.