Tập lệnh liên kết vùng chứa

Một tập lệnh được liên kết với một 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ài liệu đó chứ không phải là một tập lệnh độc lập. Tệp mà tập lệnh liên kết được đính kèm được gọi là "vùng chứa". 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 tập lệnh liên kết không xuất hiện trong Google Drive, không thể tách khỏi tệp mà tập lệnh 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 các tập lệnh này hầu như luôn được triển khai dưới dạng ứng dụng web. Tập lệnh 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à các tiện ích bổ sung Google Workspace chưa được xuất bản và chỉ hoạt động đối với tệp mà tập lệnh 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 tập lệnh liên kết 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 mở rộng > 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 Apps Script.

Biểu mẫu

Để tạo 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 Thêm > 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 Apps Script.

Công cụ clasp không thể tạo tập lệnh liên kết, nhưng nó có thể sao chép và chỉnh sửa tập lệnh liên kết.

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ể:

Để biết thêm thông tin, hãy xem hướng dẫn về cách mở rộng Trang tính hoặc hướng dẫn về cách mở rộng Tài liệu.

Các phương thức này chỉ dành cho 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 điều kiện 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 dùng được.

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 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. Một 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ở. 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.

Điều kiện kích hoạt

Tập lệnh liên kết có thể sử dụng điều kiện 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 một tệp được mở bởi người dùng có quyền chỉnh sửa. Giống như tất cả các loại tập lệnh, tập lệnh cũng có thể sử dụng điều kiện 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 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 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.

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 đó. Cộng tác viên chỉ có quyền xem thì 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 vùng chứa của tập lệnh, hãy tham khảo bài viết Chia sẻ tệp từ Drive.

Tất 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à 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ẽ sở hữu một dự án tập lệnh mới bất kể ai đã tạo dự án đó.