Bảng thuật ngữ

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

Tiện ích bổ sung cho 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 các 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ị 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ị được phát triển tốt để tiện ích bổ sung kết nối vớ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 cho hội nghị truyền hình trên Lịch.

Xem bài viết 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 cho 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 các đối tượng tiện ích khác nhau (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 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" 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 hoạt động dựa trên thẻ.

Dữ liệu 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 hội nghị của bên thứ ba do 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 trên Lịch hỗ trợ.

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

Giải pháp hội nghị

Hì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 trên Lịch.

Xem bài viết Các giải pháp dành 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 hiện đang mở trong Gmail, sự kiện trên Lịch mà bạn đang chỉnh sửa hoặc các tệp trên Drive mà bạn đã chọn là một phần trong 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. Đối tượng này đượ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

Thực hành xác định các đ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. Việc kích hoạt theo bối 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 bối cảnh đó. Trình 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 và do đó, đây 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

Tập hợp các 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 đó, nhà phát triển 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 Tiện ích bổ sung 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 nhập ngữ cảnh cần phản hồi hoặc do người dùng tương tác 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 gọi lại đã 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 mà 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. Mã này sau đó có thể hoạt động dựa trên thông tin đó và trả về phản hồi thích hợp.

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 hoạt động dựa trên thẻ. Đa số chức năng, hành vi và chi tiết phát triển dùng để tạo tiện ích bổ sung cho Gmail giống hệt với những chi tiết dùng để tạo Tiện ích bổ sung cho Google Workspace.

Xem Tiện ích bổ sung dành cho Gmail để biết thêm thông tin. Ngoài ra, hãy xem phần 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ủ 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 của họ trong Gmail nhưng chưa mở tiện ích bổ sung). 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.

Xem 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

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ũ 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 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 bạn, 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 bổ sung, và do đó, đó 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 trong Google Tài liệu để biết thêm thông tin.

Tệp kê khai

Tệp JSON được đí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 đúng cách. Đối với Tiện ích bổ sung Google Workspace, tệp kê khai được dùng để chỉ định 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 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 ngữ cảnh. Trình kích hoạt tệp kê khai được dùng riê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 nhập ngữ cảnh cần 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ì không được tích hợp sẵn (như trình kích hoạt đơn giản) và không thể 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 nằm 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 nào. 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 lưu trữ, nơi có giao diện người dùng của Tiện ích bổ sung của Google Workspace. Tiện ích bổ sung của Gmail và Trình chỉnh sửa cũng có thể xác định các thanh bên.

Khối thông minh

Khối thông minh là đề 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 để mở 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à 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 cho mục đích xem trước đường liên kết của một dịch vụ 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 được xác định bởi một dự án Apps Script hoặc tiện ích bổ sung. Trình kích hoạt kích hoạt khi sự kiện liên quan xảy ra (ví dụ: khi mở tiện ích bổ sung) và khiến một hàm Apps Script được chỉ định (hàm của trình kích hoạt) thực thi tự động. Đố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 sẽ hiển thị trên giao diện người dùng của tiện ích bổ sung. Chỉ một số loại sự kiện nhất định mới có thể có trình kích hoạt.

Xem nội dung các đ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 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. Thẻ được tạo từ một chuỗi các đối tượng tiện ích, được xác định bằng Dịch vụ thẻ tích hợp sẵn trong Apps Script.

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 của trình xử lý tiện ích được xác định mà nó có thể sử dụng để kết nối với các thao tác. Hàm chuyển giao tiện ích xác định kiểu 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 tạo nên khả năng tương tác của tiện ích.

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