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