Bảng chú giải thuật ngữ

Các thuật ngữ sau được sử dụng trong tài liệu này.

Tiện ích bổ sung về 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 nhà cung cấp dịch vụ hội nghị truyền hình trình bày các tuỳ chọn hội nghị truyền hình trong các sự kiện trên Lịch Google. Những 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 để có thể kết nối với tiện ích bổ sung. Do yêu cầu này, hầu hết các nhà phát triển không cần tạo tiện ích bổ sung về hội nghị truyền hình trên Lịch.

Hãy xem Tiện ích bổ sung cho hội nghị truyền hình 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 các 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 về hội nghị truyền hình trên Lịch thành Tiện ích bổ sung của 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.).

Hãy 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, khi một cửa sổ hoạt động khác truy cập 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" trên giao diện người dùng của tiện ích bổ sung.

Tiện ích bổ sung của Google Workspace đều dựa trên thẻ.

Dữ liệu về hội nghị truyền hình

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ị truyền hình của bên thứ ba bằng tiện ích bổ sung của Google Workspace hoặc tiện ích bổ sung về Hội nghị truyền hình trên Lịch.

Xem Dữ liệu về hội nghị để biết thêm thông tin.

Giải pháp hội nghị

Hình ảnh minh hoạ một hội nghị truyền hình của bên thứ ba có thể được tạo từ Lịch Google bằng Tiện ích bổ sung của Google Workspace hoặc tiện ích bổ sung cho hội nghị truyền hình của Lịch Google.

Xem Giải pháp cho hội nghị để biết thêm thông tin.

Bối cảnh

Trạng thái hiện tại của ứng dụng lưu trữ. Ví dụ: thư nào đang mở trong Gmail, sự kiện trên Lịch bạn đang chỉnh sửa hoặc tệp trên Drive mà bạn đã chọn sẽ 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 thành một đối tượng sự kiện được truyền đến hàm kích hoạt dưới dạng thông số.

Kích hoạt theo ngữ cảnh

Việc xác định những điều kiện 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 một giao diện người dùng có liên quan đến ngữ cảnh đó. Đ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 đó, là một loại điều kiện kích hoạt tệp kê khai.

Tiện ích bổ sung dành cho trình chỉnh sửa

Bộ 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 đó, 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ữ.

Xem 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 trang chủ, khi tiện ích bổ sung nhập ngữ cảnh cần phản hồi hoặc do hoạt động 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 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

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 thông tin về chức năng, hành vi và quy trình phát triển được dùng để tạo tiện ích bổ sung cho Gmail giống hệt với những thông tin chi tiết dùng để tạo tiện ích bổ sung cho Google Workspace.

Hãy xem bài viết 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 đã phát hành để biết thông tin về cách chuyển đổi tiện ích bổ sung của Gmail thành Tiện ích bổ sung của 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 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 của họ trong Gmail nhưng chưa mở). Bạn sẽ xác định giao diện và hoạt động của trang chủ tiện ích bổ sung giống như mọi thẻ khác.

Xem Trang chủ để biết thêm thông tin.

Ứng dụng lưu trữ hoặc máy chủ lưu trữ

Ứng dụng Google Workspace, 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

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 sẵn Apps Script. Chỉ các Tiện ích bổ sung Trình chỉnh sửa cũ hơn mới dựa trên HTML.

Trình 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 URL của bên thứ ba hoặc URL 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. Việc kích hoạt bản 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, cũng như đị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. Đ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, do đó, đây là một loại điều kiện kích hoạt tệp kê khai.

Hãy xem bài viết 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 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 tiện ích bổ sung của Google Workspace, tệp kê khai 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 điều khiển giao diện người dùng nhất định.

Điều kiện 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. Điều kiện kích hoạt tệp kê khai được dùng riêng để tạo và hiển thị thẻ mới khi có yêu cầu trang chủ tiện ích bổ sung hoặc tiện ích bổ sung nhập 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ì chúng 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 ở bên ngoài một ngữ cảnh cụ thể; ví dụ: khi xem chuỗi email của họ trong Gmail nhưng chưa mở chuỗi email. Trang chủ là một loại thẻ không theo ngữ cảnh.

Phần ở bên phải giao diện người dùng của máy chủ lưu trữ, nơi xuất hiện giao diện người dùng của tiện ích bổ sung của Google Workspace. Tiện ích bổ sung 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 một ứng dụng Google Workspace. Khi người dùng di chuột qua một khối, họ 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 để chuyển đến 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 trang trình bày, chủ sở hữu của bản trình bày và việc 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 của mình để sử dụng khối thông minh nhằm xem trước đường liên kết cho một dịch vụ của bên thứ ba hoặc không phải của Google. Xem phần Xem trước đường liên kết trong Google Tài liệu.

Điều kiện 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. Điều kiện 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 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 trên giao diện người dùng của 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ó trình kích hoạt.

Xem điều kiện kích hoạt tiện ích bổ sung để biết thêm thông tin.

Hàm kích hoạt

Mộ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 đang được kích hoạt.

Tiện ích

Một thành phần trên giao diện người dùng như nút, trường văn bản hoặc hộp đánh dấu. Các 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 Apps Script xác định.

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 có một tập hợp các hàm trình xử lý tiện ích đã xác định mà nó có thể dùng để kết nối với các hành động. Các hàm xử lý tiện ích xác định loại tương tác 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 trong hoạt động tương tác của tiện ích.

Hãy xem bài viết Các hàm của trình xử lý tiện ích để biết thêm thông tin.