Nâng cấp tiện ích bổ sung đã xuất bản

Nếu đã tạo và phát hành tiện ích bổ sung để mở rộng Gmail hoặc Lịch, thì bạn có thể nâng cấp tiện ích bổ sung này 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ó của Gmail hoặc Lịch, sau đó phát hành tiện ích bổ sung đã nâng cấp để người dùng 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 như trang chủ.

Bước 1: Tạo bản sao của 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 như tiện ích bổ sung đã phát hành, nhưng quan trọng là 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 mã sau này nếu cần.

  1. Mở dự án Apps Script – tiện ích bổ sung Gmail hiện có hoặc tiện ích bổ sung cho Hội nghị truyền hình trên Lịch.
  2. Ở bên trái, hãy nhấp vào biểu tượng Tổng quan .
  3. Ở bên phải, hãy nhấp vào biểu tượng Tạo bản sao .
  4. Ở bên trái, nhấp vào Cài đặt dự án > Thay đổi dự án.
  5. Nhấp vào Mã số dự án GCP.
  6. Nhập cùng một số dự án liên kết với dự án tiện ích bổ sung Apps Script hiện đã phát hành của bạn.
  7. Nhấp vào Đặt dự án.

Bước 2: Tích hợp tiện ích bổ sung cho 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 của Google Workspace mà bạn muốn thêm vào tiện ích bổ sung.

  1. Lên kế hoạch cho nội dung sẽ hiển thị 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 một tổ hợp bất kỳ trên ba 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ủ, hãy quyết định xem liệu đó có thể là cùng một trang chủ hay bạn muốn có các thẻ trang chủ tuỳ chỉnh cho từng máy chủ lưu trữ.
  2. Trong dự án tiện ích bổ sung Apps Script đã sao chép, hãy tạo thẻ trang chủ bằng các hàm homepageTrigger. Hãy nhớ đưa vào mọi chức năng hoặc logic hỗ trợ cần thiết để điều khiển giao diện trang chủ mới của bạn.
  3. Cân nhắc thêm các thẻ ngữ cảnh được kích hoạt bởi hành động của người dùng, như mở chuỗi thư trên Gmail hoặc sự kiện trên Lịch.

  4. 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 callback 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 này vẫn chứa các trường đối tượng sự kiện tương tự mà các tiện ích bổ sung cho hội nghị truyền hình của Gmail và Lịch sử dụng, 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 thức 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 cho Google Workspace đã thay đổi đáng kể so với cấu trúc mà các tiện ích bổ sung dành cho Gmail và các tiện ích bổ sung cho 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 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ả tài sản phụ có liên quan cho 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 yêu cầu.

Để tìm hiểu thêm về tệp kê khai của tiện ích bổ sung Google Workspace, hãy xem Tệp kê khai.

Tiện ích bổ sung cho Gmail

Trường tệp kê khai gốc Việc cần làm
gmail.composeTrigger Chuyển đến addOns.gmail.composeTrigger.
gmail.contextualTriggers[] Chuyển danh sách này sang addOns.gmail.contextualTriggers[].
gmail.logoUrl Chuyển đến addOns.common.logoUrl.
gmail.name Chuyển đến addOns.common.name.
gmail.openLinkUrlPrefixes[] Chuyển danh sách này sang addOns.common.openLinkUrlPrefixes[].
gmail.primaryColor Chuyển đến addOns.common.layoutProperties.primaryColor.
gmail.secondaryColor Chuyển đến addOns.common.layoutProperties.secondaryColor.
gmail.universalActions[] Chuyển danh sách này 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 Chuyển đến 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 Chuyển đến addOns.calendar.createSettingsUrlFunction.
calendar.conferenceSolution[] Chuyển đến addOns.calendar.conferenceSolution[].
calendar.logoUrl Chuyển đến addOns.common.logoUrl.
calendar.name Chuyển đến 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 phát hành, hãy xem bài viết Kiểm thử tiện ích bổ sung cho 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 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 cho chúng tôi xem xét:

  1. Hãy đảm bảo tiện ích bổ sung của bạn đáp ứng tất cả yêu cầu về việc phát hành tiện ích bổ sung.

  2. Tạo phiên bản triển khai theo phiên bản của Tiện ích bổ sung trên 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 cố gắng phát hành bằng quy trình triển khai trưởng.

  3. 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 của Gmail sử dụng phạm vi Drive hoặc Lịch mới trong phiên bản Tiện ích bổ sung Google Workspace, 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 bạn đã xác minh tiện ích bổ sung trước khi chuyển sang Bước 6.

Bước 6: Cung cấp tiện ích bổ sung đã nâng cấp

  1. Mở SDK Google Workspace Marketplace.

  2. Ở 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.

  3. 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 trên Google Workspace.

  4. 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 Google Workspace ở bước trước. Nếu mã 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.

  5. Nếu bạn đã thêm các phạm vi mới vào tiện ích bổ sung trên Google Workspace, hãy nhớ thêm các phạm vi đó vào mụ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 liệt kê trong tệp kê khai của tiện ích bổ sung.

  6. 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 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 dành cho trình chỉnh sửa không?

Hầu hết các Tiện ích bổ sung dành cho Google Ads Editor đều có thể di chuyển sang Tiện ích bổ sung của Google Workspace. Tuy nhiên, bạn không thể nâng cấp lên các tiện ích bổ sung của Google Workspace dễ dàng như tiện ích bổ sung dành cho Gmail và Lịch.

Nếu muốn di chuyển Tiện ích bổ sung Editor sang Tiện ích bổ sung của Google Workspace, bạn cần ghi 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 hoạt động xử lý JavaScript lên Dịch vụ thẻ.

Một số dịch vụ trong Tiện ích bổ sung chỉnh sửa hiện có có thể không dùng được trong Dịch vụ thẻ. Ví dụ: nếu Tiện ích bổ sung chỉnh sửa chứa một bộ chọn tệp, thì Dịch vụ thẻ sẽ không có Tiện ích bổ sung cho Google Workspace.

Tôi có thể tạo một tiện ích bổ sung riêng biệt cho Google Workspace và giữ lại tiện ích bổ sung hiện có không?

Bạn có thể xây dựng thêm Tiện ích bổ sung Google Workspace dưới các tên thương hiệu khác nhau, nhưng chúng tôi không cho phép các tiện ích bổ sung cho hội nghị truyền hình của 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 trường hợ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 uỷ quyền lại tiện ích bổ sung sau khi nâng cấp không?

Miễn là tiện ích bổ sung trên Google Workspace 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 được liên kết, người dùng 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, thì người dùng phải cho phép 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 của Chrome lên 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 Chrome. Bạn phải tạo một tiện ích bổ sung mới cho Google Workspace và chuyển hướng người dùng 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 tiện ích bổ sung của Google Workspace không?

Xem nội dung Liệt kê các công cụ tích hợp ứng dụng cùng nhau.