Nếu đã 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 đó thành Tiện ích bổ sung của 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 tiện ích bổ sung hiện có cho Gmail hoặc Lịch, sau đó phát hành tiện ích bổ sung đã nâng cấp để mọi người có thể tìm thấy 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 ban đầu để giữ lại trang thông tin, số 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 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 một dự án Google Cloud với tiện ích bổ sung đã phát hành, nhưng bạn phải tạo và sử dụng bản sao của dự án Apps Script cơ bản để người dùng hiện có không bị ảnh hưởng trong quá trình bạn 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 sau này nếu cần.
- Mở dự án Apps Script tiện ích bổ sung dành cho Gmail hoặc tiện ích bổ sung hội nghị truyền hình trên Lịch hiện có.
- Ở bên trái, hãy nhấp vào biểu tượng 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 tiện ích bổ sung đã phát hành và hiện có của bạn trên Apps Script.
- 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 nội dung sẽ xuất hiện trong thẻ trang chủ của tiện ích bổ sung và liệu những nội dung đó có xuất hiện trong Gmail, Lịch, Drive hoặc bất kỳ kiểu kết hợp nào trong số 3 máy chủ lưu trữ này hay không. 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ủ hay bạn muốn 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 các thẻ trang chủ có các hàm
homepageTrigger. Đừng quê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 của bạn. Hãy cân nhắc việc thêm các thẻ theo bối cảnh được kích hoạt bằng hành động của người dùng, chẳng hạn như mở một 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 của bạn (trong hàm gọi lại tiện ích hoặc trong hàm kích hoạt theo ngữ 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 giống nhau mà các tiện ích bổ sung cho hội nghị truyền hình của Gmail và Lịch Google sử dụng, nhưng các trường ban đầu đó không còn đượ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 Tiện ích bổ sung của Google Workspace đã thay đổi đáng kể so với cấu trúc sử dụng các tiện ích bổ sung dành cho Gmail và tiện ích bổ sung về hội nghị truyền hình trên Lịch. Khi nâng cấp tiện ích bổ sung, bạn phải cập nhật các trường tệp kê khai của dự án Apps Script của tiện ích bổ sung theo bảng dưới đây. Bạn phải cập nhật tất cả các tài sản phụ có liên quan cho tài sản
addOns mới.
Ngoài ra, 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 yêu cầu.
Để tìm hiểu thêm về tệp kê khai tiện ích bổ sung của Google Workspace, hãy xem bài viết 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 trường 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
Để kiểm thử tiện ích bổ sung đã nâng cấp trước khi xuất bản, vui lòng xem bài viết Thử nghiệm 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, đều phải được phê duyệt thì mới có thể được đưa vào 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:
Hãy đảm bảo tiện ích bổ sung của bạn đáp ứng mọi yêu cầu phát hành tiện ích bổ sung.
Tạo phiên bản 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 cách sử dụng phiên bản mã bạn muốn phát hành. Đừng cố xuất bản bằng cách sử dụng triển khai head.
Nếu thêm 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 phiên bản Tiện ích bổ sung dành cho 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. 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ở 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 mình.
Hãy 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 của bạn để phản ánh 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 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 OAuth 2.0 trên trang Cấu hình. Các phạm vi được liệt kê trong mục đó 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.
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 đó, 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 nâng cấp Tiện ích bổ sung 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 của mình 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, việc nâng cấp các tiện ích này lên Tiện ích bổ sung của Google Workspace không thể dễ dàng như các tiện ích bổ sung cho Gmail và Lịch.
Nếu muốn di chuyển Tiện ích bổ sung Trình chỉnh sửa sang 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 sang Giao diện dựa trên thẻ và cập nhật cách xử lý JavaScript của bạn 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 có có thể không hoạt động trong Dịch vụ thẻ. Ví dụ: nếu Tiện ích bổ sung Trình chỉnh sửa của bạn có một bộ chọn tệp, thì sẽ không có tiện ích bổ sung nào tương đương trong Dịch vụ thẻ cho 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 các 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 chấp nhận các tiện ích bổ sung hội nghị truyền hình cho Gmail hoặc Lịch riêng biệt có 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 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 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 một dự án Cloud Platform (GCP) cơ bản với mã ứng dụng khách OAuth 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ọ đã từng cấp 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 phải cho phép các phạm vi mới đó trong lần đầu tiên họ sử dụng phiên bản tiện ích bổ sung Google Workspace của bạn.
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à bài đánh giá trang thông tin của tiện ích của Chrome. Bạn phải tạo một Tiện ích bổ sung mới của Google Workspace và hướng người dùng tiện ích của Chrome đế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 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.