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 ứng dụng có cần thêm việc gì nữa hay không hoặc đã được phê duyệt hay chưa.

  • 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 cần thiết để thực hiện việc này 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 đồng ý 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. Để biết hướng dẫn, hãy tham khả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ư trỏ đế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 chưa hoạt động đầy đủ.

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 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ối đa 50 ký tự.
  • (Đề xuất) Tên sử dụng kiểu viết hoa chữ cái đầu tiên.
  • (Được đề 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 ứ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 thể hiện chính xác và chuyển hướng đến thông tin liên quan về nhà phát triển.
  • 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 về việc 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:
    • Thương mại – Thương mại 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 thương mại.
    • Phi thương mại – Phi thương mại (người tiêu dùng) là người hành động vì mục đích không chuyên nghiệp.

    Nếu bạn không chỉ định, thì "Trạng thái người bán không 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ẽ dẫn đế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à chi tiết đều 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.
  • (Đề xuất) 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 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ử – đây không phải là ứng dụng đ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 mang thương hiệu 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 đối với 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 thì 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 trong ứ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 thao tác.
  • 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 phù hợp, 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. Các hình ảnh này thể hiện chính xác ứng dụng.
  • (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ố trường hợp 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 của bạn để 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 ký hiệu.
Ứ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 báo 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 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.
  • 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ễ.
  • Những ứ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 một 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 về môi trường dàn dựng hoặc 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:
    • 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) Để quản trị viên Workspace có thể 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 phần Đá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 hành động dự kiến và bắt buộc đề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 thành 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 trong 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 này vẫn có tài liệu phù hợp.
  • Tiện ích bổ sung sử dụng chính xác onInstall()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 phần 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ọ.
    • Để 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õ việc cần làm và cách thực hiện.
    • 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 tạo điều kiện thuận lợi nhất có thể.
    • 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 này 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 trùng lặp hoặc có nhiều hộp thoại 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 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 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ụ: tiện ích bổ sung 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 hành động nhiều lần trong khi một hành động đ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 phần tử giao diện người dùng phù hợp (chẳng hạn như các 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ợ, hãy quản lý một cách thích 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 bình thường.
  • Nếu tiện ích bổ sung sử dụng calendar.conferenceSolution, thì ít nhất một giải pháp hội nghị truyền hình sẽ được cung cấp.
  • Nếu tiện ích bổ sung cung cấp giải pháp hội nghị, 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 đến 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 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 Gmail đã chuyển đổi, thì một trang chủ mặc định sẽ được áp dụng.
  • Phần tử giao diện người dùng (chẳng hạn như thẻ 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 bổ sung 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, 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ụ của 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 dọc 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 các 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ị truyền hình 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ừ 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ụ: khi bạn xem trước đường liên kết đến một giao dịch bán hàng, thông tin như tài khoản, số tiền và giai đoạn sẽ được thêm vào.
  • 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 chỉ lưu trữ những tệp trên 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 gặp 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à bạn 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 một 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 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 biểu trưng phù hợp cho 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

  • (Được đề xuất) 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à ứng dụng web.