Một tập lệnh được liên kết với tệp Google Trang tính, Google Tài liệu, Google Trang trình bày hoặc Google Biểu mẫu nếu tập lệnh đó được tạo từ tệp đó thay vì là một tập lệnh độc lập. Tệp mà một tập lệnh liên kết được đính kèm vào được gọi là "vùng chứa". Các tập lệnh liên kết thường hoạt động giống như tập lệnh độc lập, ngoại trừ việc chúng không xuất hiện trong Google Drive, không thể tách rời khỏi tệp mà chúng được liên kết và có một số đặc quyền đặc biệt đối với tệp mẹ.
Tập lệnh cũng có thể được liên kết với Google Sites, nhưng những tập lệnh này hầu như luôn được triển khai dưới dạng ứng dụng web. Các tập lệnh được liên kết với Trang tính, Tài liệu, Trang trình bày hoặc Biểu mẫu cũng có thể trở thành ứng dụng web, mặc dù trường hợp này không phổ biến.
Tập lệnh liên kết là tiện ích bổ sung Google Workspace chưa được xuất bản và chỉ hoạt động cho tệp mà chúng được liên kết.
Tạo tập lệnh liên kết
Bạn có thể tạo tập lệnh liên kết trong Tài liệu, Trang tính, Trang trình bày và Biểu mẫu.
Tài liệu, Trang tính hoặc Trang trình bày
Để tạo một tập lệnh ràng buộc trong Tài liệu, Trang tính hoặc Trang trình bày, hãy mở một tài liệu trong Tài liệu, một bảng tính trong Trang tính hoặc một bản trình bày trong Trang trình bày rồi nhấp vào Tiện ích > Apps Script. Để mở lại tập lệnh trong tương lai, hãy làm tương tự hoặc mở tập lệnh trên trang tổng quan về Apps Script.
Biểu mẫu
Để tạo một tập lệnh liên kết trong Biểu mẫu, hãy mở một biểu mẫu rồi nhấp vào Tuỳ chọn khác > Trình chỉnh sửa tập lệnh. Để mở lại tập lệnh trong tương lai, hãy làm tương tự hoặc mở tập lệnh trên trang tổng quan Apps Script.
Công cụ clasp không thể tạo tập lệnh liên kết, nhưng có thể sao chép và chỉnh sửa các tập lệnh đó.
Phương thức đặc biệt
Tập lệnh liên kết có thể gọi một số phương thức mà tập lệnh độc lập không thể gọi:
getActiveSpreadsheet,getActiveDocument,getActivePresentationvàgetActiveFormcho phép các tập lệnh liên kết tham chiếu đến tệp mẹ mà không cần tham chiếu đến mã nhận dạng của tệp.getUicho phép các tập lệnh liên kết truy cập vào giao diện người dùng cho tệp mẹ để thêm thanh bên, hộp thoại và trình đơn tuỳ chỉnh.- Trong Trang tính,
getActiveSheet,getActiveRangevàgetActiveCellcho phép tập lệnh xác định trang tính hiện tại của người dùng, dải ô đã chọn hoặc ô riêng lẻ đã chọn.setActiveSheetvàsetActiveRangecho phép tập lệnh thay đổi các lựa chọn đó. - Trong Tài liệu,
getActiveTab,getCursorvàgetSelection, hãy để tập lệnh xác định thẻ hiện tại của người dùng, vị trí con trỏ của người dùng hoặc văn bản đã chọn.setActiveTab,setCursorvàsetSelectioncho phép tập lệnh thay đổi các lựa chọn đó.
Để biết thêm thông tin, hãy xem hướng dẫn mở rộng Trang tính hoặc hướng dẫn mở rộng Tài liệu.
Các phương thức này chỉ có sẵn cho các tập lệnh liên kết chạy từ trình chỉnh sửa tập lệnh, mục trình đơn, hộp thoại, thanh bên hoặc trình kích hoạt. Khi một tập lệnh liên kết được chạy dưới dạng ứng dụng web hoặc bằng API Google Apps Script, các phương thức này sẽ không hoạt động.
Thanh bên, hộp thoại và trình đơn tuỳ chỉnh
Các tập lệnh liên kết có thể tuỳ chỉnh Trang tính, Tài liệu và Biểu mẫu bằng cách thêm trình đơn tuỳ chỉnh và hộp thoại hoặc thanh bên. Tập lệnh chỉ có thể tương tác với giao diện người dùng cho phiên bản hiện tại của một tệp đang mở. Một tập lệnh được liên kết với một tài liệu không thể ảnh hưởng đến giao diện người dùng của một tài liệu khác.
Điều kiện kích hoạt
Tập lệnh liên kết có thể sử dụng trình kích hoạt đơn giản như hàm onOpen đặc biệt. Hàm này sẽ tự động chạy bất cứ khi nào người dùng có quyền chỉnh sửa mở một tệp. Giống như mọi loại tập lệnh, các tập lệnh này cũng có thể sử dụng trình kích hoạt có thể cài đặt.
Hàm tuỳ chỉnh
Hàm tuỳ chỉnh là một hàm trong tập lệnh được liên kết với Trang tính mà bạn gọi trực tiếp từ một ô bằng cú pháp =myFunctionName(). Hàm tuỳ chỉnh tương tự như hàng trăm hàm tích hợp sẵn trong Trang tính, chẳng hạn như AVERAGE hoặc SUM, ngoại trừ việc bạn xác định hành vi của hàm tuỳ chỉnh.
Truy cập vào các tập lệnh liên kết
Chỉ những người dùng có quyền chỉnh sửa vùng chứa mới có thể chạy tập lệnh liên kết của vùng chứa đó. Cộng tác viên chỉ có quyền xem sẽ không thể mở trình chỉnh sửa tập lệnh. Nếu tạo bản sao của tệp vùng chứa, họ sẽ trở thành chủ sở hữu của bản sao đó và có thể xem cũng như chạy bản sao của tập lệnh.
Để tìm hiểu cách chia sẻ tệp chứa của một tập lệnh, hãy tham khảo bài viết Chia sẻ tệp trong Drive.
Tất cả các tập lệnh liên kết với vùng chứa đều sử dụng cùng một danh sách truy cập của chủ sở hữu, người xem và quyền truy cập của người chỉnh sửa được xác định cho tệp vùng chứa. Chủ sở hữu vùng chứa sẽ nắm quyền sở hữu một dự án tập lệnh mới, bất kể ai đã tạo dự án đó.