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

• 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 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 có hình đại diện rõ ràng và dễ nhận ra.

• Ứ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.

• 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.

• 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 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 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 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ó 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 more_vert 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 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 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.

• 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.