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