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

Để phát hành công khai một ứng dụng trê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 rằng chúng đáp ứng các nguyên tắc của Google về thiết kế, nội dung và kiểu.

Sau khi Google xem xét ứng dụng, bạn sẽ nhận được email cho biết ứng dụng đó có cần thêm thao tá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 được xử lý thêm: 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 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 phần Chuẩn bị cho quy trình xuất bản.

Thời lượng bài đánh giá

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 đã gửi gần đây
  • 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 đánh giá

Xác minh OAuth:

  • Thiết lập màn hình xin phép bằng OAuth chưa 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 phát hành đượ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 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 dẫn đến thông tin không chính xác. Ví dụ: đường liên kết của chính sách quyền riêng tư sẽ 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 này vẫn đang được thử nghiệm và chưa sẵn sàng công khai.
  • Ứng dụng có lỗi hoặc chưa hoạt động đầy đủ chức năng.

Tiêu chí xem xét

Trước khi gửi ứng dụng để xem xét, hãy đảm bảo ứ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ể sử 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 bao gồm số phiên bản.
  • Tên 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 không vượt quá 50 ký tự.
  • (Nên dùng) Tên sử dụng kiểu viết hoa chữ cái đầu tiên.
  • (Nên dùng) Tên không có dấu câu, đặc biệt là dấu ngoặc đơn.
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à dẫn đế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 hay người 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 hành động nhân danh hoặc thay mặt cho người bán.
    • Người không phải người kinh doanh – Người không phải người kinh doanh (người tiêu dùng) là người hành động vì các mục đích không phải chuyên nghiệp.

    Nếu bạn không chỉ định, thông báo "Chưa xác định trạng thái bên giao dịch" sẽ xuất hiện trên trang danh sách cửa hàng của ứng dụng.
Nội dung mô tả về ứng dụng
  • Mọi đườ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ư 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, nội dung mô tả sẽ mô tả chức năng của dịch vụ bên thứ ba, 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.
  • Nội dung mô tả ngắn gọn và chi tiết, dễ hiểu.
  • Phần mô tả ngắn và 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ộ thuộc tính đầy đủ cho mỗi ngôn ngữ (tên, nội dung mô tả ngắn và nội dung mô tả chi tiết) được xác định chính xác mà không có sự không khớp về ngôn ngữ.
Chức năng
  • Không có lỗi rõ ràng và tất cả thao tác, bao gồm cả các trường hợp hiếm gặp, đề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 này minh hoạ rõ 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 chức năng đã có trong các sản phẩm của Google.
  • Ứng dụng này không nhằm mục đích quảng cáo hoặc gửi nội dung rác.
  • Ứng dụng này hoạt động đầy đủ và không dành cho mục đích kiểm thử. Đây không phải là một ứ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ì nhóm xem xét của Google sẽ được cung cấp một tài khoản thử nghiệm trên hệ thống của nhà phát triển.
Trải nghiệm người dùng
  • Ứng dụng (bao gồm cả tên của ứng dụng) không sử dụng tài sản thương hiệu của Google, nhãn hiệu hoặc nội dung mang 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 dùng tính năng SSO bằng một lần nhấp hoặc lý tưởng nhất là SSO không nhấp chuột.
  • Sau khi quản trị viên cấp quyền cho các phạm vi OAuth 2.0 cho miền, người dùng cá nhân sẽ không được nhắc cấp quyền cho phạm vi nữa.
  • Người dùng không phải nhập thông tin xác thực sau khi đăng nhập vào Tài khoản Google của họ. Tối đa, họ chỉ phải nhấp vào nút "Đăng nhập bằng Google" để có quyền truy cập.
  • Các thuật ngữ nhất quán, rõ ràng và dễ hiểu cho nhãn nút, mục trong trình đơn, tiêu đề và các thành phần khác của ứng dụng. Ví dụ: thay vì Có hoặc Không, nhãn tham chiếu đế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à quy trình đăng nhập có thể bắt đầu lại từ đầu.
  • Thông báo phản hồi sẽ luôn hiện ra, chẳng hạn như thông báo xác nhận hoặc thông báo lỗi, để triển khai thao tác.
  • Trang web không có đường liên kết của hình ảnh bị hỏng hoặc hình ảnh bị mờ.
Đồ hoạ
  • Các biểu tượng có kích thước chính xác, là hình vuông và có nền trong suốt. Hãy xem bài viết 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 màu 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.
  • (Nên dùng) Ảnh chụp màn hình cho thấy rõ cách sử 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 nhỏ nhất có thể và tất cả phạm vi đều tích hợp chính xác với API Dịch vụ Google.

Các yêu cầu bổ sung đối với việc tích hợp ứng dụng cụ thể

Chọn các công cụ 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á 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ể sử 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ó sẵn trong phần mô tả.
  • Tên ứng dụng bắt đầu bằng A—Z (chữ hoa) hoặc 0–9. Không được bắt đầu bằng một ký hiệu.
Ứng dụng Google Chat Trải nghiệm người dùng
  • Ứng dụng gửi tin nhắn chào mừng không theo lời nhắc mỗi khi người dùng bắt đầu một tin nhắn trực tiếp hoặc được thêm vào không gian. Tin nhắn chào mừng khác với lệnh "Help". Để biết thêm thông tin, hãy xem phần Tạo trang chủ cho ứng dụng Google Chat.
  • Ứng dụng hỗ trợ lệnh "Trợ giúp" và giúp người dùng bắt đầu sử dụng ứng dụng. Để biết thêm thông tin, hãy xem phần Phản hồi lệnh gạch chéo.
  • Ứ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 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 sai trái.
  • Thông báo sử dụng định dạng rõ ràng, súc tích 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, thì ứng dụng sẽ gửi thông báo giải thích độ 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 một không gian bằng cách sử dụng lượt đề cập bằng @.
  • Người dùng có thể xoá ứng dụng khỏi không gian bằ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 phần Tạo thẻ tương tác.
  • Bạn có thể tìm thấy ứng dụng này trong tuỳ chọn 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 phát triển hoặc môi trường thử nghiệm.
  • Bạn phải đề cập bằng @trong mọi tin nhắn gửi cho ứng dụng trong không gian. Đó là cách duy nhất để ứng dụng biết rằng nó phải phản hồi.
  • Nếu ứng dụng Chat xem trước đường liên kết từ một miền của bên thứ ba:
    • Bản xem trước đường liên kết cung cấp thông tin bổ sung, phù hợp với thông báo của người dùng. Ví dụ: việc xem trước đường liên kết đến một giao dịch bán hàng sẽ thêm các 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 mà người dùng có thể xem trước.

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

  • (Nên dùng) Để cho phép quản trị viên Workspace thay mặt người dùng trong tổ chức 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ó hình đại diện rõ ràng và dễ nhận ra.
Ứng dụng Google Drive Chức năng
  • Ứng dụng không sử dụng tiện ích trình duyệt Chrome để cung cấp chức năng bằng cách trực tiếp thao tác với HTML của Drive.
  • Nếu sử dụng các phạm vi nhạy cảm hoặc bị hạn chế, ứng dụng của bạn phải trải qua quy trình xác minh OAuth. Xem bài viết Làm cách nào để gửi yêu cầu 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 Tại sao cần phải đánh giá bảo mật.
Ứng dụng Google Drive Trải nghiệm người dùng
  • Nếu ứng dụng lưu trữ tệp trong Drive, thì ứng dụng đó 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. Bạn có thể lưu trữ dữ liệu cấu hình trong thư mục Dữ liệu ứng dụng. Ứng dụng không kết xuất 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 được ghi nhận 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 có trong tiện ích bổ sung và cung cấp mọi 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, tiện ích bổ sung sẽ cung cấp tuỳ 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 bảng tính lên nguồn cấp dữ liệu dịch vụ web, thì tiện ích bổ sung đó sẽ có đường liên kết đến nguồn cấp dữ liệu đó để 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 các đường liên kết hoặc thông tin để dễ dàng tạo tài khoản nếu người dùng chưa có tài khoản.
  • Tiện ích bổ sung 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ỉ là các hàm tuỳ chỉnh, tiện ích bổ sung này vẫn cung cấp tài liệu thích hợp.
  • Tiện ích bổ sung sử dụng đúng onInstall() và onOpen() để điền vào trình đơn của tiện ích. Các mục trong trình đơn sẽ được điền khi tiện ích bổ sung được cài đặt lần đầu tiên và khi một tệp khác được mở. Hãy xem phần uỷ quyền Tiện ích bổ sung Trình chỉnh sửa.
  • Các chế độ uỷ quyền được thiết lập chính xác. Xem phần 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ề môi trường 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 để hiểu cơ bản 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 thư viện quá mức vì thư viện có thể khiến tiện ích bổ sung bị 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 cửa sổ hộp thoại, không phải trong cảnh báo JavaScript hay trên thanh màu đỏ mặc định. Thông báo này sẽ thông báo về vấn đề và mô tả những việc người dùng phải làm để khắc phục vấn đề bằng ngôn ngữ đơn giản.
    • Nếu có thể, nếu người dùng đang làm sai, 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ề quy tắc lập trình của tiện ích bổ sung.
  • Đường liên kết đến các trang bên ngoài mở trong cửa sổ mới và chính xác.
  • Tiện ích bổ sung này có giao diện trực quan và được thiết kế hợp lý. Điều này có nghĩa là:
    • Luôn rõ ràng về việc cần làm và cách làm.
    • Tiện ích bổ sung này dễ truy cập và dễ hiểu. Tránh sử dụng các thuật ngữ kỹ thuật và biệt ngữ.
    • Quy trình làm việc rõ ràng và được hỗ trợ nhiều 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 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 trên mỗi màn hình.
  • Tiện ích bổ sung hiển thị một hộp thoại tại một thời điểm. Không chồng chéo hoặc mở nhiều hộp thoại cùng một lúc.
  • Giao diện người dùng của tiện ích bổ sung vừa vặn trong các không gian được phân bổ:
    • Văn bản và nhãn không bị cắt bớt bằng dấu "..."
    • Người dùng không phải cuộn theo chiều 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, 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 thông qua các thay đổi về thiết kế. Ví dụ: một tiện ích bổ sung của Google Trang tính nhập dữ liệu có thể tạo ra nguy cơ ghi đè nội dung hiện có. Bạn có thể loại bỏ rủi ro này 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 các thao tác nhiều lần trong khi đang tải một thao tác. Ví dụ: các nút bị tắt hoặc ẩn 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 hệt với tên được cung cấp trong trang thông tin ứ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 tiện ích (hoặc giao diện người dùng dạng iframe trong Tiện ích bổ sung Meet) cho chức năng mong muốn. Ví dụ: sử dụng nút chuyển để chọn một giá trị boolean.

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

  • Lịch phụ và tính năng uỷ quyền được hỗ trợ. Nếu không được hỗ trợ, bạn có thể quản lý lịch phụ một cách linh hoạt. Ví dụ: việc tạo cuộc họp sẽ không bị lỗ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.
  • 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ì ít nhất một giải pháp hội nghị sẽ được cung cấp.
  • Nếu tiện ích bổ sung cung cấp các 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 cuộc họp video, 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 tiện ích bổ sung cung cấp giải pháp hội nghị, thì tiện ích đó chỉ chỉnh sửa thông tin chi tiết về hội nghị chứ không chỉnh sửa trường sự kiện nào khác.
  • Nếu tiện ích bổ sung cung cấp các giải pháp hội nghị, thì quá trình tạo hội nghị sẽ mất chưa đến 5 giây.

Tiện ích bổ sung dành 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.
  • Miền đầy đủ được chỉ định.
  • Đường dẫn không trống. Ví dụ: https://altostrat/ là OK, nhưng https://altostrat thì không.
  • Không thể sử dụng ký tự đại diện trong UrlFetchApp.

Tiện ích bổ sung của Meet

  • Luồng đăng nhập và hành trình của người dùng trong tiện ích bổ sung phải hoạt động ngay cả khi cookie của bên thứ ba bị tắt.
  • Tiện ích bổ sung phải cung cấp chức năng liên quan đến việc điều hành hoặc tham gia cuộc họp.
  • Tiện ích bổ sung không được làm 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 bạn sử dụng chế độ nhiều người chơi, tiện ích bổ sung phải cho phép tất cả những người tham gia cộng tác trên nội dung, ngay cả khi quyền không được thiết lập trước. Bạn phải có thể điều chỉnh quyền trong phiên sử dụng tiện ích 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ì trang chủ mặc định sẽ được áp dụng.
  • Thẻ tiện ích bổ sung (hoặc giao diện người dùng iframe trong tiện ích bổ sung của Meet) hoạt động đúng cách. Ví dụ: không có mục nào 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ị một thẻ trên trang chủ tuỳ chỉnh (trang web trong Tiện ích bổ sung cho Meet) để chào mừng người dùng, kèm theo nút đăng nhập (nếu cần), biểu trưng và nội dung mô tả ngắn về tiện ích bổ sung.
    • Nếu được kích hoạt, nút đăng nhập 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 vặn trong các không gian được phân bổ:
    • Văn bản và nhãn không bị cắt bớt bằng dấu "..."
    • Người dùng không phải cuộn theo chiều 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 thư viện quá mức vì thư viện có thể khiến tiện ích bổ sung bị 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 cuộ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 của 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, phù hợp cho người dùng. Ví dụ: việc xem trước đường liên kết đến một thoả thuận 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.

Để 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 của Drive

  • Nếu ứng dụng lưu trữ tệp trong Drive, nó 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. Bạn có thể lưu trữ dữ liệu cấu hình trong thư mục Dữ liệu ứng dụng. Ứng dụng không kết xuất 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ữ các tệp trong Drive được kết nối với chức năng được ghi nhận của tiện ích bổ sung.

Tiện ích bổ sung dành cho Gmail

  • Tiện ích bổ sung này 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.
  • Trình đơn Hành động khác chứa các thao tác phổ biến hoạt động đúng cách. Ví dụ: Đăng xuất, Giới thiệu, Hỗ trợ, v.v.

Tiện ích bổ sung của Meet

  • Nếu tiện ích bổ sung yêu cầu giấy phép hoặc gói thuê bao: Người dùng phải thấy một thông báo dễ hiểu khi 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ề giấy 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 phương án hành động để người dùng khắc phục tình huống.
  • 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 có thể cần thiết để 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 trang web thương mại phải cung cấp đường liên kết đến một trang web cung cấp 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 bằng tính năng Một lần chạm tại phần Hiển thị Google One Tap và một phương thức dự phòng "Đăng nhập bằng Google" tại 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ó 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 trên tiện ích bổ sung phải hoạt động ngay cả khi cookie của bên thứ ba bị tắt.
  • Tiện ích bổ sung không được có tính năng cuộn theo chiều ngang trong iframe.
  • Nếu muốn sử dụng sân khấu chính, 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 với nội dung cùng một lúc. Đối với trải nghiệm chơi đơn, 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 danh tính của người dùng đã đăng nhập.
  • (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 ra (nếu có).
  • (Nên dùng) Bạn nên chọn nội dung thông qua giao diện duyệt nội dung có nội dung mới 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 sẽ đóng bảng điều khiển bên sau khi khởi chạy sang 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 cho 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 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ị truyền hình sẽ tuân thủ các yêu cầu đối với 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 với 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 của 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 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 URL biểu trưng phù hợp cho chế độ tối trong manifest tiện ích bổ sung
Tiện ích bổ sung của Google Workspace OAuth

Tiện ích bổ sung của 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à ứng dụng web.