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 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 (chẳng hạn như quyền truy cập vào các tệp Google Trang tính hoặc Gmail) dựa trên việc quét mã. Mã được chú thích vẫn có thể tạo yêu cầu uỷ quyền. Nếu một tập lệnh cần được uỷ quyền, bạn sẽ thấy một trong các hộp thoại uỷ quyền hiển thị ở đây khi tập lệnh đó chạy.
Các tập lệnh mà bạn đã uỷ quyền trước đó cũng yêu cầu uỷ quyền bổ sung nếu một thay đổi mã thêm các 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 một 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 quyền cho Tài khoản Google của bạn. (Để truy cập vào trang này trong tương lai, hãy truy cập vào 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 Xoá ở bên phải, rồi nhấp vào OK trong hộp thoại xuất hiện.
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à do đó là dữ liệu mà tập lệnh có thể truy cập — thay đổi tuỳ theo trường hợp chạy tập lệnh, như 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 sẽ được tính cho người dùng đang sử dụng bàn phím |
| Ứng dụng web hoặc tiện ích Google Sites | Người dùng ở bàn phím hoặc chủ sở hữu tập lệnh, 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 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. Để 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ể sử dụng chú thích đố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 tập lệnh chính thực sự 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 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 mô hình uỷ quyền giống 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, các hàm onOpen(e) và onEdit(e) của chúng chạy ở chế độ không uỷ quyền, cho thấy một số chức năng bổ sung. Để biết thêm thông tin, hãy xem hướng dẫn về vòng đời uỷ quyền 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ả dự án Apps Script, phải tuân theo các giới hạn uỷ quyền. Hãy xem phần Giới hạn người dùng ứng dụng OAuth để biết thông tin chi tiết.