Các thuật ngữ sau đây được sử dụng trong toàn bộ tài liệu này.
Tiện ích bổ sung cho tính năng hội nghị truyền hình trên Lịch
Một loại tiện ích bổ sung đặc biệt dùng để cho phép nhà cung cấp hội nghị truyền hình trình bày các lựa chọn hội nghị truyền hình trong sự kiện trên Lịch Google. Các tiện ích bổ sung này yêu cầu một giải pháp hội nghị được phát triển tốt để tiện ích bổ sung có thể kết nối. Do yêu cầu này, hầu hết các nhà phát triển không bao giờ cần tạo tiện ích bổ sung hội nghị trên Lịch.
Hãy xem phần Tiện ích hội nghị trên Lịch để biết thêm thông tin. Ngoài ra, hãy xem bài viết Nâng cấp tiện ích bổ sung đã phát hành để biết thông tin về cách chuyển đổi tiện ích bổ sung hội nghị trên Lịch thành tiện ích bổ sung Google Workspace.
Thẻ
Một "trang" duy nhất của giao diện người dùng tiện ích bổ sung. Thẻ bao gồm nhiều đối tượng tiện ích (nút, trường văn bản, tiêu đề, v.v.).
Xem phần Thẻ để biết thêm thông tin.
Dựa trên thẻ
Một tiện ích bổ sung có giao diện người dùng xuất hiện dưới dạng một ngăn trong thanh bên (hoặc trên thiết bị di động, dưới dạng một cửa sổ hoạt động khác được truy cập thông qua trình đơn). Tiện ích bổ sung có một thanh công cụ ở trên cùng giúp xác định tiện ích bổ sung và hiển thị một thẻ – về cơ bản là "trang" của giao diện người dùng của tiện ích bổ sung.
Tiện ích bổ sung của Google Workspace dựa trên thẻ.
Dữ liệu hội nghị
Tập hợp thông tin mà Lịch Google cần để cho phép người dùng tạo và tham gia các cuộc họp của bên thứ ba do tiện ích bổ sung Google Workspace hoặc tiện ích bổ sung hội nghị trên Lịch hỗ trợ.
Hãy xem phần Dữ liệu hội nghị để biết thêm thông tin.
Giải pháp hội nghị
Hình ảnh đại diện cho một cuộc họp của bên thứ ba có thể được tạo từ Lịch Google bằng tiện ích bổ sung Google Workspace hoặc tiện ích bổ sung hội nghị trên Lịch.
Hãy xem phần Giải pháp hội nghị để biết thêm thông tin.
Ngữ cảnh
Trạng thái hiện tại của ứng dụng lưu trữ. Ví dụ: thư nào hiện đang mở trong Gmail, sự kiện nào trên Lịch mà bạn đang chỉnh sửa hoặc tệp nào trên Drive mà bạn đã chọn là một phần của ngữ cảnh hiện tại của ứng dụng lưu trữ. Ngữ cảnh, cùng với các thông tin khác, được thu thập vào một đối tượng sự kiện được truyền vào hàm kích hoạt dưới dạng tham số.
Kích hoạt theo ngữ cảnh
Phương pháp xác định các trình kích hoạt sẽ kích hoạt khi người dùng nhập một ngữ cảnh cụ thể, chẳng hạn như khi họ mở một chuỗi email trong Gmail. Tính năng kích hoạt theo ngữ cảnh cho phép tiện ích bổ sung của bạn cung cấp giao diện người dùng phù hợp với ngữ cảnh đó. Trình kích hoạt theo ngữ cảnh được định cấu hình trong tệp kê khai của dự án tập lệnh bổ sung và do đó là một loại trình kích hoạt tệp kê khai.
Tiện ích bổ sung dành cho trình chỉnh sửa
Bộ loại tiện ích bổ sung ban đầu chỉ cho phép các tiện ích của Google Tài liệu, Trang tính, Biểu mẫu hoặc Trang trình bày. Tiện ích bổ sung của trình chỉnh sửa không dựa trên thẻ; thay vào đó, các tiện ích này yêu cầu nhà phát triển tạo giao diện người dùng từ HTML và CSS thô. Mỗi tiện ích bổ sung của trình chỉnh sửa chỉ có thể mở rộng một ứng dụng lưu trữ.
Hãy xem phần Tiện ích bổ sung dành cho trình chỉnh sửa để biết thêm thông tin chi tiết.
Đối tượng sự kiện
Đối tượng JSON được tạo tự động khi có yêu cầu về trang chủ, khi tiện ích bổ sung chuyển sang ngữ cảnh cần phản hồi hoặc do kết quả của các lượt tương tác của người dùng với tiện ích trong giao diện tiện ích bổ sung. Sau khi được tạo, các đối tượng sự kiện sẽ được truyền đến một hàm kích hoạt hoặc hàm gọi lại được chỉ định. Mục đích của đối tượng sự kiện là truyền thông tin từ môi trường phía máy khách của người dùng (chẳng hạn như thông tin họ đã nhập vào tiện ích giao diện tiện ích bổ sung) đến mã phía máy chủ của tiện ích bổ sung. Sau đó, mã này có thể hành động dựa trên thông tin đó và trả về phản hồi thích hợp.
Hãy xem phần Đối tượng sự kiện để biết thêm thông tin chi tiết.
Tiện ích bổ sung dành cho Gmail
Một tiện ích bổ sung chỉ mở rộng Gmail. Tiện ích bổ sung của Gmail dựa trên thẻ. Hầu hết các chức năng, hành vi và thông tin chi tiết về quá trình phát triển dùng để tạo tiện ích bổ sung cho Gmail đều giống với các thông tin chi tiết dùng để tạo tiện ích bổ sung cho Google Workspace.
Hãy xem phần Tiện ích bổ sung của Gmail để biết thêm thông tin. Ngoài ra, hãy xem bài viết Nâng cấp tiện ích bổ sung đã xuất bản để biết thông tin về cách chuyển đổi tiện ích bổ sung dành cho Gmail thành tiện ích bổ sung dành cho Google Workspace.
Trang chủ
Thẻ giao diện người dùng gốc của một tiện ích bổ sung. Trang chủ sẽ hiển thị khi người dùng mở tiện ích bổ sung và cho phép tiện ích bổ sung hiển thị nội dung bên ngoài một ngữ cảnh cụ thể (ví dụ: khi người dùng đang xem chuỗi email trong Gmail nhưng chưa mở chuỗi email nào). Bạn xác định giao diện và hành vi của trang chủ tiện ích bổ sung như bất kỳ thẻ nào khác.
Hãy xem phần Trang chủ để biết thêm thông tin.
Máy chủ hoặc Ứng dụng lưu trữ
Ứng dụng Google Workspace mà một tiện ích bổ sung của Google Workspace mở rộng, chẳng hạn như Gmail hoặc Lịch Google.
Dựa trên HTML
Tiện ích bổ sung có giao diện người dùng được xác định bằng HTML và CSS thay vì Dịch vụ thẻ tích hợp sẵn trong Apps Script. Chỉ tiện ích bổ sung của Trình chỉnh sửa cũ mới dựa trên HTML.
Điều kiện kích hoạt bản xem trước đường liên kết
Tính năng xem trước đường liên kết sẽ kích hoạt khi người dùng tương tác với một URL của bên thứ ba hoặc không phải của Google trong một ứng dụng lưu trữ của Google, chẳng hạn như Google Tài liệu. Tính năng kích hoạt bản xem trước đường liên kết cho phép bạn xác định mẫu URL để xem trước từ dịch vụ hoặc API của mình, đồng thời định cấu hình nội dung xem trước, bao gồm cả khối thông minh và thẻ xem trước. Trình kích hoạt xem trước đường liên kết được định cấu hình trong tệp kê khai của dự án tập lệnh tiện ích bổ sung và do đó là một loại trình kích hoạt tệp kê khai.
Hãy xem phần Xem trước đường liên kết bằng khối thông minh để biết thêm thông tin.
Tệp kê khai
Tệp JSON đính kèm vào một dự án Apps Script. Tệp kê khai được dùng để xác định thông tin dự án mà tập lệnh cần để chạy chính xác. Đối với các tiện ích bổ sung của Google Workspace, tệp kê khai được dùng để chỉ định những máy chủ lưu trữ mà tiện ích bổ sung có thể mở rộng và cung cấp một số chế độ cài đặt kiểm soát giao diện người dùng.
Trình kích hoạt tệp kê khai
Một điều kiện kích hoạt được xác định trong tệp kê khai của dự án, chẳng hạn như điều kiện kích hoạt trang chủ hoặc điều kiện kích hoạt theo ngữ cảnh. Trình kích hoạt tệp kê khai chỉ được dùng để tạo và hiển thị thẻ mới khi có yêu cầu về trang chủ tiện ích bổ sung hoặc tiện ích bổ sung đó đi vào một ngữ cảnh yêu cầu cập nhật màn hình.
Điều kiện kích hoạt tệp kê khai khác với các điều kiện kích hoạt khác trong Apps Script vì các điều kiện này không được tích hợp sẵn (như điều kiện kích hoạt đơn giản) và không thể được tạo theo phương thức lập trình bằng Dịch vụ tập lệnh của Apps Script (như điều kiện kích hoạt có thể cài đặt).
Thẻ không theo ngữ cảnh
Thẻ hiển thị nội dung khi người dùng không ở trong một ngữ cảnh cụ thể; ví dụ: khi xem chuỗi email trong Gmail nhưng chưa mở một chuỗi email nào. Trang chủ là một loại thẻ không theo ngữ cảnh.
Thanh bên
Phần ở bên phải giao diện người dùng của máy chủ lưu trữ, nơi giao diện người dùng của tiện ích bổ sung Google Workspace xuất hiện. Tiện ích bổ sung của Gmail và Trình chỉnh sửa cũng có thể xác định thanh bên.
Khối thông minh
Khối thông minh là nội dung đề cập đến một người, tệp, sự kiện trên lịch hoặc thực thể khác trong ứng dụng Google Workspace. Khi di chuột qua một khối, người dùng cũng có thể xem trước nội dung bổ sung về tệp hoặc đường liên kết. Ví dụ: khi người dùng di chuột qua một khối cho bản trình bày trên Google Trang trình bày, họ sẽ thấy ảnh chụp màn hình của một trang trình bày, chủ sở hữu của bản trình bày và liệu họ đã xem bản trình bày trước đó hay chưa.
Bạn có thể định cấu hình tiện ích bổ sung để sử dụng khối thông minh nhằm xem trước đường liên kết đến một dịch vụ bên thứ ba hoặc không phải của Google. Xem bài viết Xem trước đường liên kết trong Google Tài liệu.
Kích hoạt
Một điều kiện và phản hồi sự kiện tự động do dự án Apps Script hoặc tiện ích bổ sung xác định. Trình kích hoạt sẽ kích hoạt khi sự kiện liên kết với trình kích hoạt đó xảy ra (ví dụ: khi một tiện ích bổ sung được mở) và khiến một hàm Apps Script được chỉ định (hàm trình kích hoạt) tự động thực thi. Đối với các tiện ích bổ sung của Google Workspace, các hàm kích hoạt thường tạo Thẻ mới để kiểm soát phần nào của giao diện người dùng tiện ích bổ sung sẽ hiển thị. Chỉ một số loại sự kiện nhất định mới có thể có điều kiện kích hoạt.
Hãy xem phần trình kích hoạt tiện ích bổ sung để biết thêm thông tin.
Hàm kích hoạt
Hàm Apps Script trong một dự án thực thi để phản hồi một điều kiện kích hoạt được kích hoạt.
Tiện ích
Một thành phần trên giao diện người dùng, chẳng hạn như nút, trường văn bản hoặc hộp đánh dấu. Thẻ được tạo từ một chuỗi các đối tượng tiện ích, do Dịch vụ thẻ tích hợp sẵn trong Apps Script xác định.
Hãy xem phần Tiện ích để biết thêm thông tin.
Hàm xử lý tiện ích
Hàm liên kết một tiện ích cụ thể với một đối tượng hành động cụ thể. Mỗi loại tiện ích có một tập hợp các hàm trình xử lý tiện ích được xác định mà tiện ích đó có thể dùng để kết nối với các thao tác. Hàm xử lý tiện ích xác định loại tương tác của người dùng kích hoạt hành động kết quả và là một thành phần quan trọng của khả năng tương tác của tiện ích.
Hãy xem Hàm trình xử lý tiện ích để biết thêm thông tin.