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