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 tự động xác định phạm vi uỷ quyề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ã bị đưa ra nhận xét vẫn có thể tạo một 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 hiển thị tại đây khi tập lệnh đó chạy.
Các tập lệnh mà bạn đã uỷ quyền trước đó cũng sẽ yêu cầu uỷ quyền bổ sung nếu việc thay đổi mã có thêm dịch vụ mới. Các 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 làm theo các bước sau:
- Hãy truy cập vào 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 có lượt 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 hiện ra.
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 trường hợp 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 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, giới hạn hạn mức lại 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 có quyền truy cập vào chủ sở hữu tập lệnh hoặc bàn phím, tuỳ thuộc vào các tuỳ chọn đã 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 đ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, 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 có sử dụng tiện ích bổ sung hoặc tập lệnh, thay vì toàn bộ bảng tính, tài liệu hoặc biểu mẫu của người dùng. Để làm như vậ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 chứa 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 nhiều nội dung 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ư các tập lệnh
liên kết với một tài liệu. Tuy nhiên, trong một số trường hợp nhất định, các hàm onOpen(e) và onEdit(e) của chúng sẽ chạy ở chế độ không được uỷ quyền, với 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ả dự án Apps Script, phải tuân theo giới hạn uỷ quyền. Xem bài viết Giới hạn về người dùng đối với ứng dụng OAuth để biết thông tin chi tiết.