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

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 đó chứ không phải dưới dạng tập lệnh độc lập. Tệp mà tập lệnh ràng buộc được đính kèm được gọi là "vùng chứa". Các tập lệnh ràng buộc thường hoạt động giống như các tập lệnh độc lập, ngoại trừ việc không xuất hiện trong Google Drive, không thể tách chúng khỏi tệp họ bị ràng buộc bởi và nhận được một số đặc quyền đối với tệp mẹ.

Lưu ý rằng các 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. Chữ viết 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.

Lưu ý: Các tập lệnh ràng buộc sẽ bị huỷ xuất bản một cách hiệu quả tiện ích bổ sung chỉ hoạt động cho tệp mà chúng liên kết.

Tạo tập lệnh ràng buộc

Google 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 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 và nhấp vào Tiện ích > Apps Script. Cách mở lại tập lệnh trong làm tương tự hoặc mở tập lệnh từ Trang tổng quan Apps Script.

Google Biểu mẫu

Để tạo một tập lệnh ràng buộc 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 Thêm > Tập lệnh trình chỉnh sửa. Để mở lại tập lệnh trong tương tự, hãy làm tương tự hoặc mở tập lệnh từ Trang tổng quan Apps Script.

Lưu ý: Công cụ clasp không thể tạo tập lệnh ràng buộc, nhưng có thể sao chép và chỉnh sửa chúng.

Phương thức đặc biệt

Các tập lệnh ràng buộc có thể gọi một vài phương thức mà các 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 gốc của chúng mà không cần tham chiếu đến mã của tệp.
• getUi cho phép các tập lệnh ràng buộc truy cập vào giao diện người dùng để tệp mẹ của chúng 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, getCursor() và getSelection() cho phép tập lệnh xác định vị trí con trỏ của người dùng hoặc văn bản đã chọn. setCursor(position) và setSelection(range) cho phép tập lệnh thay đổi các vị trí đó.

Để 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.

Lưu ý: Các phương thức này chỉ dành cho các tập lệnh ràng buộc chạy từ trình chỉnh sửa tập lệnh, các mục trong trình đơn, hộp thoại, thanh bên hoặc điều kiện kích hoạt. Khi bị ràng buộc tập lệnh được chạy dưới dạng ứng dụng web hoặc thông qua API Apps Script, các phương pháp này không .

Trình đơn, hộp thoại và thanh bên tuỳ chỉnh

Tập lệnh ràng buộc 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. Xin lưu ý rằng Tuy nhiên, tập lệnh chỉ có thể tương tác với giao diện người dùng cho bản sao hiện tại của một 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 tài liệu khác.

Tiện ích bổ sung cũng có thể thêm trình đơn, hộp thoại và thanh bên tuỳ chỉnh. Bạn nên phát triển các tiện ích bổ sung sử dụng tập lệnh độc lập.

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 giới hạn hoặc độc lập tập lệnh và muốn chia sẻ tập lệnh đó với mọi người, Apps Script giúp bạn xuất bản tập lệnh của mình dưới dạng để người dùng khác có thể cài đặt tiện ích bổ sung đó từ cửa hàng tiện ích bổ sung.

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

Tập lệnh ràng buộc có thể sử dụng các điều kiện kích hoạt đơn giản chẳng hạn như hàm onOpen() đặc biệt, hàm này 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, chúng có thể đồng thời 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 một tập lệnh được 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ách sử dụng =myFunctionName(). Do đó, hàm tuỳ chỉnh tương tự như hàng trăm các 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 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 ràng buộc của vùng chứa đó. Cộng tác viên chỉ có quyền xem không thể mở tập lệnh trình chỉnh sửa, mặc dù nếu họ tạo một bản sao của tệp vùng chứa, chúng sẽ trở thành chủ sở hữu 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 một tập lệnh, hãy tham khảo bài viết Chia sẻ tệp từ Google Drive.

Tất cả các tập lệnh ràng buộc vùng chứa đều sử dụng cùng một chủ sở hữu, người xem và danh sách 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ẽ thực hiện quyền sở hữu một dự án tập lệnh mới, bất kể ai là người tạo ra dự án đó.