Tập lệnh được liên kết với tệp Google Trang tính, Tài liệu, Trang trình bày hoặc Biểu mẫu nếu tập lệnh đó được tạo từ tài liệu đó thay vì dưới dạng tập lệnh độc lập. Tệp mà 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 như các 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 khỏi tệp liên kết và có một số đặc quyền đặc biệt so với tệp mẹ.
Xin lưu ý rằng bạn cũng có thể liên kết tập lệnh với Google Sites, nhưng các tập lệnh này gần như luôn được triển khai dưới dạng ứng dụng web. Các tập lệnh liên kết với Google 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ù điều này không phổ biến.
Tạo tập lệnh liên kết
Google Tài liệu, Trang tính hoặc Trang trình bày
Để tạo tập lệnh liên kết trong Google 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, bảng tính trong Trang tính hoặc 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 từ trang tổng quan về Apps Script.
Google Biểu mẫu
Để tạo tập lệnh liên kết trong Google Biểu mẫu, hãy mở một biểu mẫu rồi nhấp vào biểu tượng 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 từ trang tổng quan về Apps Script.
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()
,getActivePresentation()
vàgetActiveForm()
cho 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.getUi
cho phép các tập lệnh liên kết truy cập vào giao diện người dùng của tệp mẹ để thêm trình đơn, hộp thoại và thanh bên tuỳ chỉnh.- Trong Google Trang tính,
getActiveSheet()
,getActiveRange()
vàgetActiveCell()
cho 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.setActiveSheet(sheet)
vàsetActiveRange(range)
cho phép tập lệnh thay đổi các lựa chọn đó. - Trong Google Tài liệu,
getActiveTab()
,getCursor()
vàgetSelection()
cho phép tập lệnh xác định thẻ hiện tại của người dùng, vị trí của con trỏ của người dùng hoặc văn bản đã chọn.setActiveTab(tabId)
,setCursor(position)
vàsetSelection(range)
cho 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 Google Trang tính hoặc hướng dẫn mở rộng Google Tài liệu.
Trình đơn, hộp thoại và thanh bên tuỳ chỉnh
Tập lệnh liên kết có thể tuỳ chỉnh Google 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. Tuy nhiên, hãy lưu ý rằng 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 tệp đang mở. Tức là một tập lệnh 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.
Kênh bổ sung
Tiện ích bổ sung chạy trong Gmail, Google Trang tính, Tài liệu, Trang trình bày và Biểu mẫu. Nếu bạn đã phát triển một tập lệnh liên kết hoặc độc lập và muốn chia sẻ tập lệnh đó với mọi người, thì Apps Script cho phép bạn xuất bản tập lệnh dưới dạng tiện ích bổ sung để người dùng khác có thể cài đặt tập lệnh đó từ cửa hàng tiện ích bổ sung.
Điều kiện kích hoạt
Tập lệnh liên kết có thể sử dụng các 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ư tất cả các loại tập lệnh, 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 liên kết với Google Trang tính mà bạn gọi trực tiếp từ một ô bằng cú pháp =myFunctionName()
. Do đó, 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 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.
Quyền truy cập vào 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 đó. Những cộng tác viên chỉ có quyền xem không thể mở trình chỉnh sửa tập lệnh, mặc dù 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 vùng chứa của tập lệnh, hãy tham khảo bài viết Chia sẻ tệp từ Google Drive.