Yêu cầu và quy trình xem xét ứng dụng trên Google Workspace Marketplace

Để xuất bản công khai một ứng dụng lên Google Workspace Marketplace, Google sẽ xem xét ứng dụng và trang thông tin của ứng dụng để đảm bảo chúng đáp ứng các nguyên tắc của Google về thiết kế, nội dung và phong cách.

Sau khi Google xem xét ứng dụng của bạn, bạn sẽ nhận được email cho biết liệu ứng dụng có cần thêm công việc hay không hoặc liệu ứng dụng có được phê duyệt hay không.

  • Nếu ứng dụng của bạn cần thêm công việc: Bạn sẽ nhận được một tài liệu đánh giá có thông tin cụ thể về những điểm cần cải thiện. Khắc phục các vấn đề và gửi lại ứng dụng của bạn để chúng tôi xem xét.
  • Nếu nhóm xem xét phê duyệt ứng dụng của bạn: Ứng dụng sẽ tự động được xuất bản và bạn sẽ nhận được email thông báo.

Trước khi gửi ứng dụng đi xem xét, hãy đảm bảo rằng ứng dụng của bạn đã sẵn sàng phát hành. Để biết thông tin chi tiết, hãy xem bài viết Chuẩn bị cho quy trình xuất bản.

Thời lượng xem xét

Quá trình xem xét ứng dụng thường mất vài ngày. Thời gian xử lý phụ thuộc vào:

  • Số lượng ứng dụng được gửi gần đây
  • Số lượng công việc bổ sung mà ứng dụng của bạn cần

Những lý do phổ biến khiến ứng dụng không vượt qua quy trình xem xét

Xác minh OAuth:

  • Thiết lập màn hình xin phép OAuth không chính xác. Ví dụ: loại người dùng được đặt thành Nội bộ hoặc trạng thái xuất bản được đặt thành Kiểm thử.

  • Ứng dụng chưa hoàn tất quy trình xác minh OAuth.

Vấn đề về trang thông tin ứng dụng:

  • Sử dụng không phù hợp nhãn hiệu của Google trong tên ứng dụng, biểu trưng hoặc nội dung mô tả ứng dụng. Để xem hướng dẫn, hãy truy cập vào Nguyên tắc sử dụng thương hiệu của Google Workspace Marketplace.

  • Đường liên kết không hoạt động hoặc trỏ đến thông tin không chính xác. Ví dụ: đường liên kết đến chính sách quyền riêng tư dẫn đến trang hỗ trợ dành cho nhà phát triển.

  • Ảnh chụp màn hình và hình ảnh có chất lượng thấp hoặc không thể hiện chính xác các chức năng của ứng dụng.

Trạng thái sẵn sàng của ứng dụng:

  • Ứng dụng vẫn đang được kiểm thử và chưa sẵn sàng cho công chúng.
  • Ứng dụng có lỗi hoặc không hoạt động đầy đủ chức năng.

Tiêu chí đánh giá

Trước khi gửi ứng dụng đi xem xét, hãy đảm bảo rằng ứng dụng của bạn đáp ứng mọi yêu cầu và tuân thủ các chính sách chương trình của Google Workspace Marketplace.

Yêu cầu đối với tất cả ứng dụng

Bạn có thể dùng hộp đánh dấu để theo dõi quy trình xem xét sơ bộ.

Danh mục Tiêu chí
Tên ứng dụng
  • Không có trang thông tin ứng dụng nào khác có cùng tên.
  • Tên này không mạo danh một nhà phát triển, pháp nhân hoặc ứng dụng khác. Xem Chính sách về hành vi mạo danh và xuyên tạc danh tính.
  • Tên không có số phiên bản.
  • Tên này khớp với tên trên màn hình xin phép bằng OAuth.
  • Tên không mơ hồ hoặc quá chung chung.
  • Tên có từ 50 ký tự trở xuống.
  • (Đề xuất) Tên sử dụng kiểu viết hoa chữ cái đầu tiên.
  • (Đề xuất) Tên không có dấu câu, đặc biệt là dấu ngoặc đơn.
  • (Đề xuất) Tên này khớp với tên xuất hiện trong các ứng dụng của Google Workspace. Ví dụ: trong tiện ích bổ sung của Google Workspace, tên trong tệp kê khai tương tự như tên được cung cấp trong trang thông tin của ứng dụng.
Thông tin về nhà phát triển
  • Tên nhà phát triển và trang web của nhà phát triển trình bày chính xác và chuyển hướng đến thông tin liên quan về nhà phát triển.
  • Tên và trang web của nhà phát triển không cung cấp thông tin sai lệch về danh tính hoặc mối liên kết của nhà phát triển. Xem Chính sách về hành vi mạo danh và xuyên tạc danh tính.
  • Theo luật bảo vệ người tiêu dùng, người tiêu dùng ở Khu vực kinh tế Châu Âu (EEA) phải được thông báo liệu người bán trên Google Workspace Marketplace là người bán thương mại hay người bán phi thương mại:
    • Người bán – Người bán là người hành động vì các mục đích liên quan đến hoạt động thương mại, kinh doanh, thủ công hoặc nghề nghiệp; hoặc nhân danh hoặc thay mặt cho một người bán.
    • Pháp nhân phi thương mại – Pháp nhân phi thương mại (người tiêu dùng) là người hành động vì mục đích phi chuyên nghiệp.

    Nếu bạn không chỉ định, thì "Trạng thái người bán chưa xác định" sẽ xuất hiện trên trang trang thông tin trên Cửa hàng Play của ứng dụng.
Nội dung mô tả về ứng dụng
  • Tất cả đường liên kết được cung cấp đều hoạt động và dẫn đến thông tin chính xác. Ví dụ: đường liên kết đến chính sách quyền riêng tư sẽ trỏ đến một trang mô tả chính sách quyền riêng tư.
  • Nếu ứng dụng tương tác với một dịch vụ bên thứ ba, thì nội dung mô tả sẽ cho biết dịch vụ bên thứ ba đó làm gì, cách ứng dụng tương tác với dịch vụ đó và có thể liên kết đến trang web có liên quan.
  • Phần mô tả ngắn và mô tả chi tiết dễ hiểu.
  • Nội dung mô tả ngắn và nội dung mô tả chi tiết không giống nhau.
  • (Nên dùng) Thông tin về giá đầy đủ và chính xác.
  • (Nên dùng) Bạn xác định chính xác toàn bộ các thuộc tính theo từng ngôn ngữ (tên, nội dung mô tả ngắn và nội dung mô tả chi tiết) mà không có sự khác biệt về ngôn ngữ.
Chức năng
  • Không có lỗi rõ ràng và tất cả các thao tác, kể cả trường hợp đặc biệt, đều hoạt động đầy đủ. Thời gian tải được quản lý bằng các chỉ báo tải.
  • Ứng dụng minh hoạ rõ ràng các hoạt động tương tác với API của Google.
  • Ứng dụng cung cấp một chức năng mới hoặc mở rộng không tương đương với những chức năng đã có trong các sản phẩm của Google.
  • Ứng dụng không nhằm mục đích quảng cáo hoặc gửi nội dung rác.
  • Ứng dụng hoạt động đầy đủ chức năng và không dành cho mục đích kiểm thử – ứng dụng không phải là một sản phẩm đang trong quá trình phát triển.
  • Nếu ứng dụng tương tác với các tính năng dành cho người dùng hoặc người dùng trả phí, thì một tài khoản kiểm thử trên hệ thống của nhà phát triển sẽ được cung cấp cho nhóm đánh giá của Google.
Trải nghiệm người dùng
  • Ứng dụng (bao gồm cả tên) không sử dụng tài sản thương hiệu, nhãn hiệu hoặc nội dung lồng ghép thương hiệu của Google. Xem Nguyên tắc sử dụng thương hiệu của Google Workspace Marketplace.
  • Bạn chỉ cần uỷ quyền và đăng nhập một lần. Ứng dụng sử dụng tính năng SSO bằng một cú nhấp chuột hoặc lý tưởng nhất là SSO không cần nhấp chuột.
  • Sau khi quản trị viên cấp quyền cho các phạm vi OAuth 2.0 của miền, người dùng cá nhân sẽ không được nhắc lại về quyền truy cập theo phạm vi.
  • Người dùng không phải nhập thông tin đăng nhập sau khi đăng nhập vào Tài khoản Google của họ. Nhiều nhất là họ phải nhấp vào nút "Đăng nhập bằng Google" để có quyền truy cập.
  • Các nhãn nút, mục trong trình đơn, tiêu đề và các phần tử khác của ứng dụng đều có các thuật ngữ nhất quán, rõ ràng và dễ hiểu. Ví dụ: thay vì Có hoặc Không, nhãn sẽ đề cập đến tên hành động như Xoá và Huỷ.
  • Nếu cần đăng nhập, chức năng đăng xuất sẽ hoạt động đúng cách. Mã thông báo sẽ bị thu hồi và quá trình đăng nhập có thể bắt đầu lại từ đầu.
  • Phản hồi luôn xuất hiện, chẳng hạn như thông báo xác nhận hoặc thông báo lỗi, cho các hành động.
  • Không có đường liên kết hình ảnh bị hỏng hoặc hình ảnh bị mờ.
Đồ hoạ
  • Biểu tượng có kích thước chính xác, hình vuông và có nền trong suốt. Xem Thành phần đồ hoạ.
  • Biểu tượng thể hiện đúng tên hoặc chức năng của ứng dụng.
  • Biểu tượng có màu (không phải thang độ xám).
  • Biểu tượng không sử dụng nhãn hiệu của Google.
  • Ảnh chụp màn hình và hình ảnh không bị mờ, khó đọc hoặc không phù hợp. Chúng thể hiện chính xác ứng dụng.
  • Biểu tượng, ảnh chụp màn hình và hình ảnh không bắt chước đặc điểm nhận dạng bằng hình ảnh của các thương hiệu hoặc ứng dụng khác. Xem Chính sách về hành vi mạo danh và xuyên tạc danh tính.
  • (Nên dùng) Ảnh chụp màn hình cho thấy rõ cách sử dụng ứng dụng và chức năng của ứng dụng.
OAuth
  • Ứng dụng đã vượt qua quy trình xác minh OAuth, sử dụng phạm vi OAuth hẹp nhất có thể và tất cả các phạm vi đều tích hợp đúng cách với API Dịch vụ của Google.

Các yêu cầu bổ sung đối với một số hoạt động tích hợp ứng dụng cụ thể

Chọn các chế độ tích hợp ứng dụng có trong trang thông tin ứng dụng để xem các tiêu chí đánh giá có liên quan. Bạn có thể nhấp vào tên cột để sắp xếp tiêu chí, ví dụ: theo danh mục.

Bạn có thể dùng hộp đánh dấu để theo dõi quy trình xem xét sơ bộ.

Tích hợp ứng dụng Danh mục Tiêu chí
Ứng dụng Google Chat Tên
  • Các nút để giao tiếp với ứng dụng có trong phần mô tả.
  • Tên ứng dụng bắt đầu bằng A – Z (chữ hoa) hoặc 0 – 9. Tên này không được bắt đầu bằng một biểu tượng.
Ứng dụng Google Chat Chức năng
Ứng dụng Google Chat Trải nghiệm người dùng
  • Ứng dụng sẽ gửi một thông điệp chào mừng không được nhắc mỗi khi người dùng bắt đầu một tin nhắn trực tiếp hoặc ứng dụng được thêm vào một Không gian. Thông điệp chào mừng khác với lệnh "Trợ giúp". Xem tài liệu.
  • Ứng dụng hỗ trợ lệnh "Trợ giúp" và giúp người dùng bắt đầu. Xem tài liệu.
  • Ứng dụng này luôn phản hồi khi được nói chuyện trong một không gian hoặc cuộc trò chuyện trực tiếp trên Chat.
  • Tin nhắn sử dụng đúng chính tả, cách viết hoa, dấu chấm câu và ngữ pháp. Tin nhắn không chứa nội dung độc hại, phản cảm hoặc xúc phạm.
  • Các thông báo sử dụng định dạng rõ ràng, ngắn gọn và nhất quán cho văn bản hoặc thẻ theo yêu cầu của Google.
  • Nếu phản hồi mất hơn 2 giây, ứng dụng sẽ gửi một thông báo giải thích sự chậm trễ.
  • Các ứng dụng gửi thông báo cho phép người dùng tắt thông báo.
  • Người dùng có thể thêm ứng dụng vào không gian bằng cách @tên người dùng đến ứng dụng.
  • Người dùng có thể xoá ứng dụng khỏi không gian bằng cách sử dụng trình đơn Xem thành viên.
  • Ứng dụng cho người dùng biết mọi thứ cần thiết để tương tác với ứng dụng.
  • Định dạng thẻ mà ứng dụng sử dụng đáp ứng các yêu cầu của Google. Xem tài liệu.
  • Bạn có thể tìm thấy ứng dụng này trong mục Tìm ứng dụng trong trình đơn Chat.
  • Các URL bên ngoài mà ứng dụng tương tác không thuộc môi trường dàn dựng hoặc môi trường phát triển.
  • Bạn phải đề cập đến ứng dụng bằng @trong mọi tin nhắn gửi cho ứng dụng trong các không gian. Đó là cách duy nhất để ứng dụng biết rằng ứng dụng phải phản hồi.
  • Nếu ứng dụng Chat xem trước các đường liên kết từ một miền của bên thứ ba:
    • Tính năng xem trước đường liên kết cung cấp thông tin bổ sung có liên quan cho tin nhắn của người dùng. Ví dụ: xem trước đường liên kết đến một giao dịch bán hàng sẽ thêm thông tin như tài khoản, số tiền và giai đoạn.
    • Nhà phát triển có liên kết với miền được xem trước.

    Để tìm hiểu về cách xem trước đường liên kết, hãy xem tài liệu.

  • (Đề xuất) Để cho phép quản trị viên Workspace thay mặt người dùng trong tổ chức của họ cài đặt ứng dụng của bạn, ứng dụng của bạn phải có khả năng nhận và gửi tin nhắn trực tiếp.
Ứng dụng Google Chat Đồ hoạ
  • Ứng dụng có một hình đại diện rõ ràng và dễ nhận biết.
Ứng dụng Google Drive Chức năng
  • Ứng dụng không dùng tiện ích của trình duyệt Chrome để cung cấp chức năng bằng cách thao tác trực tiếp với HTML của Drive.
  • Nếu sử dụng các phạm vi nhạy cảm hoặc hạn chế, ứng dụng của bạn phải trải qua quy trình xác minh OAuth. Xem phần Gửi ứng dụng để xác minh.
  • Nếu sử dụng các phạm vi bị hạn chế, ứng dụng của bạn cũng phải trải qua quy trình đánh giá bảo mật. Xem Đánh giá bảo mật.
Ứng dụng Google Drive Trải nghiệm người dùng
  • Nếu lưu trữ tệp trong Drive, ứng dụng sẽ cho phép người dùng chọn một thư mục hoặc tạo và sử dụng lại một thư mục dành riêng cho ứng dụng. Dữ liệu cấu hình có thể được lưu trữ trong thư mục Dữ liệu ứng dụng. Ứng dụng không chuyển các tệp vào thư mục Drive của tôi của người dùng.
  • Ứng dụng chỉ lưu trữ các tệp trong Drive được kết nối với chức năng đã ghi lại của ứng dụng.
Tiện ích bổ sung dành cho trình chỉnh sửa Chức năng
  • Các thao tác bắt buộc và dự kiến đều có trong tiện ích bổ sung này, đồng thời tiện ích bổ sung này cung cấp tất cả các công cụ cần thiết để hoàn tất quy trình làm việc. Ví dụ:
    • Nếu áp dụng kiểu cho toàn bộ tài liệu, thì tiện ích bổ sung sẽ cung cấp lựa chọn chỉ áp dụng kiểu cho văn bản đã chọn.
    • Nếu tiện ích bổ sung tải dữ liệu trong bảng tính lên một nguồn cấp dữ liệu dịch vụ web, thì tiện ích bổ sung đó sẽ có một đường liên kết đến nguồn cấp dữ liệu đó để bạn dễ dàng điều hướng.
    • Nếu yêu cầu người dùng phải có tài khoản, thì tiện ích bổ sung sẽ cung cấp đường liên kết hoặc thông tin để người dùng dễ dàng tạo tài khoản nếu chưa có.
  • Tiện ích bổ sung này có các mục trong trình đơn ở thẻ tiện ích bổ sung.
  • Ngay cả khi tiện ích bổ sung chỉ có các hàm tuỳ chỉnh, thì tiện ích bổ sung đó vẫn có tài liệu phù hợp.
  • Tiện ích bổ sung sử dụng chính xác onInstall() và onOpen() để điền sẵn vào trình đơn. Các mục trong trình đơn sẽ xuất hiện khi tiện ích bổ sung được cài đặt lần đầu và khi một tệp khác được mở. Xem phần Uỷ quyền cho tiện ích bổ sung dành cho trình chỉnh sửa.
  • Bạn đã thiết lập đúng các chế độ uỷ quyền. Xem Các chế độ uỷ quyền.
  • Tiện ích bổ sung phải được triển khai trong thời gian chạy V8 của Apps Script. Để biết thêm thông tin, hãy xem bài viết Tổng quan về thời gian chạy V8.
Tiện ích bổ sung dành cho trình chỉnh sửa Trải nghiệm người dùng
  • Tiện ích bổ sung này cung cấp tất cả thông tin cần thiết để bạn hiểu rõ về sản phẩm và cách sử dụng sản phẩm.
  • Mã tiện ích bổ sung không sử dụng quá nhiều thư viện vì thư viện có thể khiến tiện ích bổ sung giảm hiệu suất.
  • Tránh lỗi nếu có thể và quản lý đúng cách nếu không:
    • Thông báo lỗi xuất hiện trong một cửa sổ hộp thoại, chứ không phải trong cảnh báo JavaScript hoặc trên thanh màu đỏ mặc định. Thông báo này cho biết vấn đề và mô tả những việc mà người dùng phải làm để khắc phục vấn đề đó bằng ngôn ngữ đơn giản.
    • Nếu người dùng đang làm sai điều gì đó, thì một nút sẽ xuất hiện để khắc phục vấn đề cho họ (nếu có thể).
    • Để biết thêm thông tin, hãy xem hướng dẫn về kiểu cho tiện ích bổ sung.
  • Đường liên kết đến các trang bên ngoài mở ra trong cửa sổ mới và chính xác.
  • Tiện ích bổ sung này trực quan và được thiết kế đẹp mắt. Điều này có nghĩa là:
    • Bạn luôn biết rõ phải làm gì và làm như thế nào.
    • Tiện ích bổ sung này dễ sử dụng và dễ hiểu. Tránh dùng thuật ngữ chuyên môn và biệt ngữ.
    • Quy trình làm việc rõ ràng và được hỗ trợ tối đa.
    • Người dùng và nội dung của họ được bảo vệ an toàn nhất có thể.
  • Tiện ích bổ sung này tuân theo hướng dẫn về kiểu giao diện người dùng cho tiện ích bổ sung của trình chỉnh sửa và sử dụng gói CSS cho tiện ích bổ sung của trình chỉnh sửa.
  • Tiện ích bổ sung chỉ sử dụng một hành động chính màu xanh dương cho mỗi màn hình.
  • Tiện ích bổ sung này chỉ hiển thị một hộp thoại tại một thời điểm. Không có nhiều hộp thoại chồng lên nhau hoặc mở cùng một lúc.
  • Giao diện người dùng của tiện ích bổ sung vừa khít với các không gian được phân bổ:
    • Văn bản và nhãn không bị cắt bằng dấu "..."
    • Người dùng không cần phải cuộn dọc nhiều.
    • Chiều rộng nội dung không vượt quá 300p để không có thanh cuộn ngang.
  • Tiện ích bổ sung này yêu cầu xác nhận hoặc hiển thị cảnh báo cho tất cả các hành động nhạy cảm. Ví dụ: nếu tiện ích bổ sung sắp ghi đè tất cả nội dung trong một bảng tính, thì người dùng sẽ được cảnh báo và xác nhận hành động trước khi hành động đó xảy ra.

    Bạn có thể tránh yêu cầu này bằng cách thay đổi thiết kế. Ví dụ: một tiện ích bổ sung của Google Trang tính nhập dữ liệu sẽ tạo ra nguy cơ ghi đè nội dung hiện có. Bạn có thể loại bỏ rủi ro bằng cách tạo một trang tính cho dữ liệu làm hành động mặc định.

  • Người dùng không thể kích hoạt nhiều thao tác trong khi một thao tác đang tải. Ví dụ: các nút sẽ tắt hoặc ẩn trong khi một thao tác đang tải.
Tiện ích bổ sung của Google Workspace Tên

Tiện ích bổ sung cho Lịch

  • Nếu tiện ích bổ sung sử dụng calendar.name hoặc common.name, thì tên trong tệp kê khai sẽ giống với tên được cung cấp trong trang thông tin của ứng dụng.
  • Nếu tiện ích bổ sung sử dụng calendar.conferenceSolution, thì tên giải pháp hội nghị sẽ không chứa "Lịch Google".
  • (Nên dùng) Nếu tiện ích bổ sung sử dụng calendar.conferenceSolution, thì tên giải pháp hội nghị không được vượt quá 30 ký tự.
Tiện ích bổ sung của Google Workspace Chức năng
  • Tiện ích bổ sung sử dụng đúng phần tử trên giao diện người dùng (chẳng hạn như tiện ích hoặc giao diện người dùng được đặt trong iframe trong tiện ích bổ sung Meet) cho chức năng mong muốn. Ví dụ: sử dụng một nút chuyển để chọn giá trị boolean.

Tiện ích bổ sung cho Lịch

  • Hỗ trợ lịch phụ và uỷ quyền, hoặc nếu không được hỗ trợ, thì được quản lý một cách phù hợp. Ví dụ: việc tạo hội nghị truyền hình sẽ không thất bại nếu người dùng chọn một lịch khác mà họ có quyền chỉnh sửa khi tạo sự kiện.
  • Các sự kiện định kỳ hoạt động chính xác.
  • Nếu tiện ích bổ sung sử dụng calendar.conferenceSolution, thì bạn phải cung cấp ít nhất một giải pháp hội nghị.
  • Nếu tiện ích bổ sung cung cấp giải pháp hội nghị truyền hình, thì các trường dữ liệu hội nghị thích hợp sẽ được sử dụng. Ví dụ: đường liên kết hội nghị truyền hình, số điện thoại, đường liên kết SIP, mã truy cập và các thuộc tính được hỗ trợ khác sử dụng các trường dữ liệu có cấu trúc và không được cung cấp trong trường ghi chú.
  • Nếu cung cấp giải pháp hội nghị truyền hình, thì tiện ích bổ sung này chỉ chỉnh sửa thông tin chi tiết về hội nghị chứ không chỉnh sửa các trường sự kiện khác.
  • Nếu tiện ích bổ sung cung cấp giải pháp hội nghị truyền hình, thì quá trình tạo hội nghị sẽ mất chưa đến 5 giây.

Tiện ích bổ sung cho Gmail

Nếu tiện ích bổ sung sử dụng UrlFetchApp hoặc OpenLinkUrl:

  • URL hợp lệ.
  • URL sử dụng HTTPS chứ không phải HTTP.
  • Bạn đã chỉ định miền đầy đủ.
  • Đường dẫn không được để trống. Ví dụ: https://altostrat/ là OK, nhưng https://altostrat thì không.
  • Bạn không thể sử dụng ký tự đại diện trong UrlFetchApp.

Tiện ích bổ sung Meet

  • Tiện ích bổ sung đăng nhập và hành trình của người dùng phải hoạt động ngay cả khi cookie của bên thứ ba bị vô hiệu hoá.
  • Tiện ích bổ sung phải cung cấp chức năng liên quan đến hoạt động hoặc việc tham gia một cuộc họp.
  • Tiện ích bổ sung không được làm bất cứ điều gì khiến người dùng rời khỏi cuộc họp, chẳng hạn như làm mới trình duyệt.
  • Nếu sử dụng trải nghiệm nhiều người chơi, tiện ích bổ sung phải cho phép tất cả người tham gia cộng tác trên nội dung ngay cả khi bạn chưa đặt trước quyền. Bạn phải có thể điều chỉnh quyền trong phiên sử dụng tiện ích bổ sung cộng tác.
  • Tiện ích bổ sung phải xử lý việc huỷ luồng hoạt động bắt đầu và cho phép người dùng bắt đầu lại hoạt động từ ứng dụng.
  • Tiện ích bổ sung phải cung cấp một bảng điều khiển bên để đăng nhập và thiết lập trải nghiệm hoạt động.
  • Tiện ích bổ sung không được cung cấp chức năng mời bot hoặc dựa vào sự hiện diện của bot trong cuộc họp
Tiện ích bổ sung của Google Workspace Trải nghiệm người dùng
  • Tiện ích bổ sung có trang chủ. Nếu tiện ích bổ sung Google Workspace của bạn là một tiện ích bổ sung dành cho Gmail đã chuyển đổi, thì một trang chủ mặc định sẽ được áp dụng.
  • Phần tử trên giao diện người dùng (chẳng hạn như thẻ tiện ích bổ sung hoặc giao diện người dùng được đặt trong iframe trong các tiện ích bổ sung của Meet) hoạt động đúng cách. Ví dụ: không có các mục trùng lặp; các nút quay lại, làm mới và cập nhật hoạt động tương ứng.
  • Sau khi người dùng cho phép tiện ích bổ sung, tiện ích này sẽ hiển thị thông tin (chẳng hạn như thẻ trang chủ tuỳ chỉnh hoặc trang web trong tiện ích bổ sung Meet) để chào mừng người dùng bằng một nút đăng nhập (nếu cần), biểu trưng và nội dung mô tả ngắn gọn về tiện ích bổ sung.
    • Nếu nút đăng nhập được kích hoạt, thì nút này sẽ hiển thị một trang đăng nhập tuỳ chỉnh của nhà cung cấp bên thứ ba, cho biết rõ rằng có một dịch vụ bên thứ ba đang hoạt động bên ngoài Google Workspace.
  • Giao diện người dùng của tiện ích bổ sung vừa khít với các không gian được phân bổ:
    • Văn bản và nhãn không bị cắt bằng dấu "..."
    • Người dùng không cần phải cuộn theo chiều dọc quá nhiều.
    • Chiều rộng nội dung không vượt quá 300p để không có thanh cuộn ngang.
  • Mã của tiện ích bổ sung không sử dụng quá nhiều thư viện vì thư viện có thể khiến tiện ích bổ sung giảm hiệu suất.

Tiện ích bổ sung cho Lịch

  • Nếu tiện ích bổ sung cung cấp giải pháp hội nghị truyền hình, thì các hội nghị được tạo sẽ hợp lệ và hiển thị chính xác trên trang web hội nghị của bên thứ ba.

Tiện ích bổ sung cho Tài liệu

Nếu tiện ích bổ sung xem trước đường liên kết từ một miền của bên thứ ba (khối thông minh):

  • Bản xem trước đường liên kết cung cấp thông tin bổ sung có liên quan cho người dùng. Ví dụ: xem trước đường liên kết đến một giao dịch bán hàng sẽ thêm thông tin như tài khoản, số tiền và giai đoạn.
  • Nhà phát triển có liên kết với miền được xem trước (mẫu URL được chỉ định sẽ kích hoạt việc tạo khối thông minh).

Để biết thêm thông tin, hãy xem bài viết Xem trước đường liên kết bằng khối thông minh.

Tiện ích bổ sung cho Drive

  • Nếu lưu trữ tệp trong Drive, ứng dụng sẽ cho phép người dùng chọn một thư mục hoặc tạo và sử dụng lại một thư mục dành riêng cho ứng dụng. Dữ liệu cấu hình có thể được lưu trữ trong thư mục Dữ liệu ứng dụng. Ứng dụng không chuyển các tệp vào thư mục Drive của tôi của người dùng.
  • Tiện ích bổ sung này chỉ lưu trữ những tệp trong Drive được kết nối với chức năng đã ghi lại của tiện ích bổ sung.

Tiện ích bổ sung cho Gmail

  • Tiện ích bổ sung không đề cập hoặc liên kết đến các tiện ích của trình duyệt Chrome mà không có lý do chính đáng.
  • Trình đơn Thao tác khác chứa các thao tác chung hoạt động đúng cách. Ví dụ: Đăng xuất, Giới thiệu, Hỗ trợ, v.v.

Tiện ích bổ sung Meet

  • Nếu tiện ích bổ sung yêu cầu có giấy phép hoặc gói thuê bao: Bạn phải cho người dùng thấy một thông báo thân thiện khi họ không có giấy phép.
  • Nếu người dùng không thể sử dụng tiện ích bổ sung do vấn đề về cấp phép, thì thông báo lỗi phải nêu rõ lý do không thể sử dụng tiện ích bổ sung và đề xuất một cách hành động để người dùng khắc phục tình trạng này.
  • Trang thông tin của tiện ích bổ sung trên Google Workspace Marketplace phải nêu rõ thông tin chi tiết về các yêu cầu về giấy phép và gói thuê bao mà người dùng có thể phải đáp ứng để sử dụng tiện ích bổ sung. Nếu tiện ích bổ sung có một cấp trả phí, thì trang thông tin trên Marketplace phải cung cấp một đường liên kết đến trang web có thêm thông tin về giá hoặc cách liên hệ với nhân viên bán hàng.
  • Khi người dùng chưa đăng nhập, tiện ích bổ sung phải hiển thị lời nhắc đăng nhập Một lần chạm có trong phần Hiển thị tính năng Một lần chạm của Google và một phương án dự phòng "Đăng nhập bằng Google" có trong phần Xác thực. Ngoài cơ chế "Đăng nhập bằng Google", các lựa chọn đăng nhập khác cũng có thể được cung cấp.
  • Tiện ích bổ sung phải có thiết kế thích ứng để có thể điều chỉnh nội dung cho phù hợp với nhiều kích thước.
  • Hành trình của người dùng tiện ích bổ sung phải hoạt động ngay cả khi cookie của bên thứ ba bị vô hiệu hoá.
  • Tiện ích bổ sung không được có chế độ cuộn ngang trong iframe.
  • Nếu muốn sử dụng sân khấu chính, thì tiện ích bổ sung phải được thiết kế cho trải nghiệm nhiều người chơi và cho phép nhiều người tham gia thao tác nội dung cùng lúc. Đối với trải nghiệm một người chơi, nhà phát triển nên sử dụng bảng điều khiển bên.
  • (Nên dùng) Tiện ích bổ sung phải cho biết người dùng đã đăng nhập là ai.
  • (Nên dùng) Lựa chọn bản địa hoá: ngôn ngữ phải dựa trên lựa chọn ưu tiên tại địa phương do trình duyệt đặt (nếu có).
  • (Đề xuất) Người dùng nên chọn nội dung thông qua giao diện duyệt xem nội dung có nội dung được truy cập gần đây.
  • (Nên dùng) Nếu không cần bảng điều khiển bên nữa, tiện ích bổ sung nên đóng bảng điều khiển bên sau khi khởi chạy vào giai đoạn chính.
Tiện ích bổ sung của Google Workspace Đồ hoạ

Tiện ích bổ sung cho Lịch

  • Biểu trưng của giải pháp hội nghị truyền hình là một URL công khai. Xem phần Cung cấp biểu trưng của giải pháp hội nghị.
  • Nếu tiện ích bổ sung sử dụng calendar.conferenceSolution, thì biểu trưng của giải pháp hội nghị phải tuân thủ các yêu cầu về calendar.logoUrl. Xem Tài nguyên tệp kê khai lịch.
  • Nếu tiện ích bổ sung sử dụng calendar.logoUrl hoặc common.logoUrl, thì biểu trưng sẽ giống hệt biểu tượng được cung cấp trong trang thông tin ứng dụng.
  • Nếu tiện ích bổ sung sử dụng calendar.logoUrl hoặc common.logoUrl, thì URL của biểu trưng sẽ bắt đầu như sau: https://lh3.googleusercontent.com/

Tiện ích bổ sung Meet

  • Biểu trưng thương hiệu của tiện ích bổ sung phải có kích thước và kiểu dáng sao cho người dùng có thể nhận dạng được trong bảng điều khiển bên của Meet.
  • Bạn phải chỉ định các URL phù hợp cho biểu trưng ở chế độ tối trong tệp kê khai của tiện ích bổ sung
Tiện ích bổ sung của Google Workspace OAuth

Tiện ích bổ sung cho Drive

  • (Nên dùng) Nếu bạn muốn nhận siêu dữ liệu có giới hạn, thì tiện ích bổ sung sẽ bao gồm phạm vi drive.addons.metadata.readonly.
Ứng dụng web Chức năng
  • URL điều hướng chung trỏ đến một ứng dụng web. Một trang web đơn giản không có chức năng không được coi là một ứng dụng web.