Nếu đã tạo và xuất bản một tiện ích bổ sung để mở rộng Gmail hoặc Lịch, bạn có thể nâng cấp thành Tiện ích bổ sung của Google Workspace. Các hướng dẫn trong trang này trình bày chi tiết cách thức để thêm chức năng của Google Workspace vào các tiện ích bổ sung hiện có cho Gmail hoặc Lịch Google và sau đó xuất bản tiện ích bổ sung đã nâng cấp để mọi người có thể tìm thấy và cài đặt tiện ích đó.
Bạn có thể chuyển chức năng mới vào ứng dụng gốc tiện ích bổ sung để giữ lại trang thông tin, số lượt cài đặt và người dùng trên Google Workspace Marketplace. Khi nâng cấp, bạn cũng có thể khai thác các tính năng mới của tiện ích bổ sung của Google Workspace chẳng hạn như trang chủ.
Bước 1: Tạo bản sao dự án Apps Script của tiện ích bổ sung
Tiện ích bổ sung đã nâng cấp của bạn sử dụng cùng dự án Google Cloud với dự án đã phát hành tiện ích bổ sung khác, nhưng điều quan trọng là phải tạo và sử dụng bản sao của các Ứng dụng cơ bản Tập lệnh dự án để người dùng hiện tại không bị ảnh hưởng trong khi bạn kiểm thử phiên bản đã nâng cấp. Cũng nâng cấp bản sao của dự án tập lệnh gốc có nghĩa là bạn luôn có thể truy cập vào mã gốc và có thể triển khai lại mã sau này nếu nếu cần.
- Mở tiện ích bổ sung Gmail hoặc tiện ích bổ sung hội nghị truyền hình trên Lịch mà bạn hiện có dự án.
- Ở bên trái, hãy nhấp vào Tổng quan .
- Ở bên phải, hãy nhấp vào biểu tượng Tạo bản sao .
- Ở bên trái, hãy nhấp vào Cài đặt dự án > Thay đổi dự án.
- Nhấp vào Số dự án GCP.
- Nhập cùng một số dự án liên kết với dự án Apps Script tiện ích bổ sung mà bạn hiện có.
- Nhấp vào Đặt dự án.
Bước 2: Tích hợp tiện ích bổ sung của Google Workspace
Bạn phải thiết kế và triển khai mọi tính năng tiện ích bổ sung của Google Workspace mà bạn muốn thêm vào tiện ích bổ sung của mình.
- Lên kế hoạch cho những nội dung sẽ xuất hiện trong tiện ích bổ sung thẻ trang chủ và liệu chúng sẽ xuất hiện trong Gmail, Lịch, Drive hoặc bất kỳ kết hợp nào trong số ba máy chủ lưu trữ. Nếu bạn muốn có một trang chủ trong nhiều máy chủ lưu trữ, hãy quyết định xem có thể là cùng một trang chủ hoặc nếu bạn muốn có thẻ trang chủ tuỳ chỉnh cho mỗi máy chủ lưu trữ.
- Trong dự án tiện ích bổ sung bổ sung Apps Script đã sao chép, hãy tạo trang chủ
các thẻ có
homepageTrigger. Hãy nhớ thêm mọi hàm hoặc logic hỗ trợ cần thiết để kiểm soát giao diện trang chủ mới của bạn. Cân nhắc việc thêm các thẻ theo bối cảnh được kích hoạt bởi hành động của người dùng, như mở Chuỗi thư trong Gmail hoặc Sự kiện trên lịch.
Cập nhật mọi quyền truy cập vào đối tượng sự kiện trong tiện ích bổ sung (trong hàm callback tiện ích hoặc trong điều kiện kích hoạt theo ngữ cảnh hàm) để sử dụng hàm đã cập nhật cấu trúc đối tượng sự kiện. Cấu trúc mới vẫn chứa các trường đối tượng sự kiện tương tự được sử dụng Tiện ích bổ sung cho hội nghị truyền hình của Gmail và Lịch Google, nhưng các trường ban đầu đó là không được dùng nữa và cuối cùng sẽ bị xoá.
Bước 3: Cập nhật tệp kê khai của tiện ích bổ sung
Cách thức lưu trữ thông tin cấu hình trong
cấu trúc tệp kê khai của
Tiện ích bổ sung cho Google Workspace đã thay đổi đáng kể so với cấu trúc của các tiện ích bổ sung cho Gmail
và tiện ích bổ sung cho hội nghị truyền hình trên Lịch Google. Khi nâng cấp tiện ích bổ sung của mình, bạn phải cập nhật các trường tệp kê khai của dự án Apps Script trong tiện ích bổ sung theo
vào các bảng bên dưới. Bạn phải cập nhật tất cả các tài sản phụ có liên quan lên
Thuộc tính addOns.
Hãy nhớ cập nhật tệp kê khai
Trường oauthScopes dưới dạng
cần thiết để phản ánh các quyền mà tiện ích bổ sung mà bạn đã cập nhật yêu cầu.
Để tìm hiểu thêm về tệp kê khai tiện ích bổ sung của Google Workspace, xem Tệp kê khai.
Tiện ích bổ sung dành cho Gmail
| Trường tệp kê khai gốc | Việc cần làm |
|---|---|
gmail.composeTrigger |
Di chuyển tới addOns.gmail.composeTrigger. |
gmail.contextualTriggers[] |
Chuyển danh sách này sang addOns.gmail.contextualTriggers[]. |
gmail.logoUrl |
Di chuyển tới addOns.common.logoUrl. |
gmail.name |
Di chuyển tới addOns.common.name. |
gmail.openLinkUrlPrefixes[] |
Chuyển danh sách này sang addOns.common.openLinkUrlPrefixes[].
|
gmail.primaryColor |
Di chuyển tới addOns.common.layoutProperties.primaryColor. |
gmail.secondaryColor |
Di chuyển tới addOns.common.layoutProperties.secondaryColor.
|
gmail.universalActions[] |
Chuyển danh sách này sang addOns.common.universalActions[]. |
gmail.universalActions[].text |
Di chuyển mỗi trường gmail.universalActions[].text đến
addOns.common.universalActions[].label tương ứng
. |
gmail.useLocalFromApp |
Di chuyển tới addOns.common.useLocaleFromApp. |
Tiện ích bổ sung cho hội nghị truyền hình trên lịch
| Trường tệp kê khai gốc | Việc cần làm |
|---|---|
calendar.createSettingsUrlFunction |
Di chuyển tới addOns.calendar.createSettingsUrlFunction. |
calendar.conferenceSolution[] |
Di chuyển tới addOns.calendar.conferenceSolution[]. |
calendar.logoUrl |
Di chuyển tới addOns.common.logoUrl. |
calendar.name |
Di chuyển tới addOns.common.name. |
Bước 4: Thử nghiệm tiện ích bổ sung đã nâng cấp
Cách thử nghiệm tiện ích bổ sung đã nâng cấp trước khi xuất bản: hãy xem bài viết Kiểm thử tiện ích bổ sung của Google Workspace.
Bước 5: Yêu cầu xem xét tiện ích bổ sung đã nâng cấp
Tất cả tiện ích bổ sung của Google Workspace, cho dù là tiện ích bổ sung đã nâng cấp hay được tạo từ đầu, phải được phê duyệt thì mới có thể xuất hiện trên Google Workspace Marketplace.
Hãy làm theo các bước sau để gửi tiện ích bổ sung của bạn cho chúng tôi xem xét:
Đảm bảo tiện ích bổ sung của bạn đáp ứng tất cả các yêu cầu đối với việc phát hành tiện ích bổ sung.
Tạo quy trình triển khai theo phiên bản của Tiện ích bổ sung Google Workspace (trong dự án Apps Script mới) bằng phiên bản mã bạn muốn phát hành. Đừng tìm cách xuất bản bằng cách dùng phần đầu triển khai.
Nếu thêm các phạm vi mới trong khi nâng cấp tiện ích bổ sung, bạn phải yêu cầu xác minh OAuth. Ví dụ: nếu tiện ích bổ sung Gmail của bạn sử dụng các phạm vi mới trên Drive hoặc Lịch trong Là phiên bản tiện ích bổ sung dành cho Google Workspace, bạn phải gửi các phạm vi mới đó để xác minh. Quy trình xác minh thường mất vài ngày để hoàn tất, vì vậy hãy bắt đầu quy trình như sớm nhất có thể. Hãy đảm bảo rằng tiện ích bổ sung của bạn đã được xác minh trước khi tiếp tục sang Bước 6.
Bước 6: Cung cấp tiện ích bổ sung đã nâng cấp
Mở SDK của Google Workspace Marketplace.
Ở bên trái, hãy nhấp vào Cấu hình. Bảng điều khiển này chứa một biểu mẫu để bạn cung cấp thông tin về tiện ích bổ sung của bạn.
Cập nhật nội dung mô tả ngắn, nội dung mô tả chi tiết và ảnh chụp màn hình trang thông tin để cho biết chức năng mới của Tiện ích bổ sung cho Google Workspace.
Trong phần Tiện ích, hãy nhấp vào nút Nâng cấp lên Nút tiện ích bổ sung của Google Workspace. Trong hộp văn bản xuất hiện, hãy nhập mã triển khai mới mà bạn đã tạo cho Tiện ích bổ sung của Google Workspace ở bước trước. Nếu mã triển khai của bạn hợp lệ, danh sách máy chủ được hỗ trợ sẽ xuất hiện.
Nếu bạn đã thêm các phạm vi mới vào Tiện ích bổ sung của Google Workspace, hãy nhớ thêm các phạm vi đó vào Phần Phạm vi của OAuth 2.0 trên trang Cấu hình. Các phạm vi được liệt kê trong phần đó phải khớp chính xác với các phạm vi được liệt kê trong tiện ích bổ sung của bạn tệp kê khai.
Hãy xác minh rằng thông tin bạn nhập vào biểu mẫu là chính xác. Sau đó: nhấp vào Lưu thay đổi.
Nếu bạn có thắc mắc hoặc gặp vấn đề trong quá trình nâng cấp tiện ích bổ sung này của Google Workspace hãy liên hệ với chúng tôi.
Câu hỏi thường gặp
Sau đây là những câu hỏi thường gặp về việc nâng cấp tiện ích bổ sung:
Tôi có thể nâng cấp Tiện ích bổ sung Trình chỉnh sửa không?
Bạn có thể di chuyển hầu hết các Tiện ích bổ sung dành cho Trình chỉnh sửa sang Tiện ích bổ sung của Google Workspace. Tuy nhiên, chúng không được đã nâng cấp lên Tiện ích bổ sung của Google Workspace một cách dễ dàng như tiện ích bổ sung cho Gmail và Lịch Google.
Nếu muốn di chuyển Tiện ích bổ sung Trình chỉnh sửa sang một Tiện ích bổ sung của Google Workspace, bạn cần phải viết lại giao diện người dùng của tiện ích bổ sung từ HTML thành thẻ Dựa trên thẻ giao diện và cập nhật JavaScript xử lý sang Dịch vụ thẻ.
Một số dịch vụ trong Tiện ích bổ sung Trình chỉnh sửa hiện có của bạn có thể không dùng được trong Dịch vụ thẻ. Ví dụ: nếu Tiện ích bổ sung của Trình chỉnh sửa có một bộ chọn tệp, thì ở đó không phải là một phiên bản tương đương có trong Dịch vụ thẻ cho Tiện ích bổ sung của Google Workspace.
Tôi có thể tạo một tiện ích bổ sung riêng biệt của Google Workspace và giữ lại tiện ích bổ sung hiện có không?
Bạn có thể tạo thêm Tiện ích bổ sung của Google Workspace dưới nhiều tên thương hiệu, nhưng chúng tôi không cho phép các tiện ích bổ sung riêng biệt cho hội nghị truyền hình của Gmail hoặc Lịch Google trong cùng tên thương hiệu với Tiện ích bổ sung của Google Workspace. Nếu bạn có thắc mắc hoặc muốn yêu cầu ngoại lệ, hãy liên hệ với chúng tôi.
Người dùng của tôi có cần cấp quyền lại cho tiện ích bổ sung sau khi nâng cấp không?
Miễn là Tiện ích bổ sung của Google Workspace sử dụng cùng nền tảng Dự án Cloud Platform (GCP), có mã ứng dụng khách OAuth được liên kết, thì người dùng của bạn sẽ không cần uỷ quyền lại các quyền mà họ đã cấp trước đó cho tiện ích bổ sung ban đầu của bạn. Tuy nhiên, nếu bạn thêm các phạm vi mới trong quá trình nâng cấp, người dùng của bạn phải cho phép các phạm vi đó phạm vi mới trong lần đầu tiên sử dụng Google Workspace của tiện ích bổ sung.
Tôi có thể nâng cấp tiện ích của Chrome lên một tiện ích bổ sung của Google Workspace và chuyển người dùng không?
Không. Bạn không thể chuyển người dùng, lượt cài đặt và trang thông tin của một tiện ích của Chrome bài đánh giá. Bạn phải tạo một tiện ích bổ sung mới của Google Workspace và chuyển hướng người dùng Chrome của bạn tiện ích bổ sung cho Google Workspace Marketplace.
Tôi có thể kết hợp nhiều tiện ích bổ sung với tiện ích bổ sung của Google Workspace không?
Xem bài viết Liệt kê các công cụ tích hợp ứng dụng cùng nhau.