Các thuật ngữ sau đây được dùng trong suốt tài liệu này.
Tiện ích bổ sung hội nghị truyền hình trên Lịch
Một loại tiện ích bổ sung đặc biệt được dùng để cho phép các nhà cung cấp dịch vụ 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 cần có một giải pháp hội nghị truyền hình được phát triển tốt để kết nối. Do yêu cầu này, hầu hết nhà phát triển không bao giờ cần tạo một tiện ích bổ sung hội nghị truyền hình trên Lịch.
Hãy xem bài viết Tiện ích hội nghị trên Lịch để biết thêm thông tin. Bạn cũng có thể 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 hội nghị truyền hình 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ẻ
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ó thể truy cập thông qua trình đơn). Tiện ích bổ sung này 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à một "trang" của giao diện người dùng 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 hội nghị do bên thứ ba cung cấp thông qua một tiện ích bổ sung của Google Workspace hoặc tiện ích bổ sung hội nghị truyền hình của Lịch.
Hãy xem Dữ liệu hội nghị để biết thêm thông tin.
Giải pháp hội nghị truyền hình
Một bản trình bày về hội nghị 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ị truyền hình của 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ụ: tin nhắn 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 đều thuộc 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 đến hàm kích hoạt dưới dạng một tham số.
Kích hoạt theo bối cảnh
Hoạt động xác định các điều kiện kích hoạt sẽ hoạt động 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 một giao diện người dùng phù hợp với ngữ cảnh đó. Các điều kiện kích hoạt theo bối cảnh được định cấu hình trong tệp kê khai của dự án tập lệnh tiện ích bổ sung, do đó, đây là một loại điều kiện kích hoạt theo tệp kê khai.
Tiện ích bổ sung dành cho trình chỉnh sửa
Nhóm 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 cho trình chỉnh sửa không dựa trên thẻ; thay vào đó, chúng 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 trang chủ được yêu cầu, khi tiện ích bổ sung nhập các bối cảnh mà tiện ích bổ sung cần phản hồi hoặc là kết quả của các lượt tương tác của người dùng với các 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 callback được chỉ định. Mục đích của các đố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 mà họ đã nhập vào các tiện ích giao diện của 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ể xử lý thông tin đó và trả về phản hồi thích hợp.
Hãy xem bài viết Đố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 cho Gmail dựa trên thẻ. Phần lớn chức năng, hành vi và thông tin chi tiết về quá trình phát triển được dùng để tạo tiện ích bổ sung cho Gmail đều giống với thông tin chi tiết được 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. Bạn cũng có thể 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 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ủ xuất hiện khi người dùng mở tiện ích bổ sung và cho phép tiện ích bổ sung của bạn hiển thị nội dung bên ngoài một bối cảnh cụ thể (ví dụ: khi người dùng đang xem chuỗi email trong Gmail nhưng chưa mở một email nào). Bạn xác định giao diện và hành vi của trang chủ tiện ích bổ sung giống như bất kỳ thẻ nào khác.
Hãy xem phần Trang chủ để biết thêm thông tin.
Ứng dụng lưu trữ hoặc Ứng dụng lưu trữ
Ứng dụng Google Workspace mà tiện ích bổ sung Google Workspace mở rộng, chẳng hạn như Gmail hoặc Lịch Google.
Dựa trên HTML
Một 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 của Apps Script. Chỉ những tiện ích bổ sung cũ của Trình chỉnh sửa mới dựa trên HTML.
Trình kích hoạt bản xem trước đường liên kết
Điều kiện kích hoạt bản 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 xem trước đường liên kết cho phép bạn xác định các 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. Các điều kiện 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 điều kiện 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
Một tệp JSON được đính kèm vào 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 đúng cách. Đối với tiện ích bổ sung của Google Workspace, tệp kê khai được dùng để chỉ định những máy chủ 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 thành phần điều khiển trên giao diện người dùng nhất định.
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 bối cảnh. Các trình kích hoạt tệp kê khai chỉ được dùng để tạo và hiển thị thẻ mới khi trang chủ của tiện ích bổ sung được yêu cầu hoặc tiện ích bổ sung chuyển sang một ngữ cảnh yêu cầu cập nhật màn hình.
Trình kích hoạt tệp kê khai khác với các trình kích hoạt khác trong Apps Script vì chúng không được tích hợp sẵn (như trình 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ư trình 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 bối cảnh cụ thể; ví dụ: khi xem chuỗi email trong Gmail nhưng chưa mở một email. Trang chủ là một loại thẻ không theo bối cảnh.
Thanh bên
Phần ở bên phải giao diện người dùng 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. Các tiện ích bổ sung của Gmail và Editor cũng có thể xác định thanh bên.
Khối thông minh
Khối thông minh là một thông tin đề cập đến một người, tệp, sự kiện trên lịch hoặc thực thể khác trong một ứ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 thẻ đến một 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 đây 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 cho dịch vụ bên thứ ba hoặc dịch vụ không phải của Google. Xem phần Xem trước đường liên kết trong Google Tài liệu.
Trigger
Một điều kiện và phản hồi tự động đối với sự kiện 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 được liên kế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 kích hoạt) tự động thực thi. Đối với các tiện ích bổ sung 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ẽ xuất hiện. 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 trình kích hoạt bổ sung để biết thêm thông tin.
Hàm kích hoạt
Một hàm Apps Script trong dự án thực thi để phản hồi một sự kiện kích hoạt.
Tiện ích
Một phần tử 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 của Apps Script xác định.
Hãy xem phần Tiện ích để biết thêm thông tin.
Hàm trình xử lý tiện ích
Một 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 đều có một nhóm 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. Các hàm trình xử lý tiện ích xác định loại lượt tương tác nào của người dùng sẽ kích hoạt hành động kết quả và là một thành phần quan trọng của tính 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.