Định cấu hình ứng dụng trong SDK Google Workspace Marketplace

Trang này giải thích cách sử dụng SDK Google Workspace Marketplace để định cấu hình và quản lý ứng dụng của bạn trên Google Workspace Marketplace.

Để cung cấp ứng dụng để người dùng sử dụng, bạn cần thiết lập ứng dụng đó trong SDK Google Workspace Marketplace. SDK Google Workspace Marketplace là một bộ công cụ cho phép bạn tạo và kiểm soát ứng dụng của mình trên Google Workspace Marketplace. Bạn sử dụng SDK Google Workspace Marketplace để quản lý các chế độ cài đặt của Marketplace, chẳng hạn như các nội dung sau:

  • Liệu ứng dụng của bạn có được cung cấp cho một tổ chức Google Workspace cụ thể (ứng dụng riêng tư) hay cho tất cả người dùng trên Marketplace (ứng dụng công khai)
  • Các kiểu người dùng Marketplace có thể cài đặt ứng dụng của bạn
  • Ứng dụng của bạn tích hợp với(những) ứng dụng Google Workspace nào
  • Các phạm vi OAuth mà ứng dụng của bạn yêu cầu
  • Thông tin về những người tạo và duy trì ứng dụng

Bất kể đang phát hành ứng dụng công khai hay riêng tư, bạn đều phải sử dụng SDK Google Workspace Marketplace để quản lý ứng dụng của mình trên Marketplace.

Bật SDK Google Workspace Marketplace

Trong dự án trên Google Cloud, hãy bật Google Workspace Marketplace SDK (nếu bạn chưa thực hiện):

  1. Mở bảng điều khiển Google Cloud.
  2. Ở trên cùng, hãy nhấp vào Chọn dự án. Nếu một dự án Google Cloud khác đã mở, hãy nhấp vào tên dự án trên Google Cloud để chuyển đổi các dự án trên Google Cloud.
  3. Chọn dự án Cloud của ứng dụng rồi nhấp vào Open (Mở).
  4. Ở trên cùng, trong thanh tìm kiếm, hãy nhập Google Workspace Marketplace SDK rồi nhấn phím Enter.

  5. Mở trang SDK Google Workspace Marketplace.

  6. Nếu bạn chưa bật SDK Google Workspace Marketplace, hãy nhấp vào Bật.

Nhập các chế độ cài đặt ứng dụng trong SDK Google Workspace Marketplace

  1. Mở Google Workspace Marketplace SDK.
  2. Chuyển tới thẻ Cấu hình ứng dụng.
  3. Điền thông tin về ứng dụng của bạn vào từng phần. Để tìm hiểu về từng chế độ cài đặt, hãy xem phần Cài đặt cấu hình ứng dụng sau đây.
  4. Nhấp vào Lưu.
  5. (Không bắt buộc) Bạn có thể xem số liệu phân tích về mức sử dụng ứng dụng trong Google Analytics. Để làm như vậy, hãy thêm mã Google Analytics vào SDK Google Workspace Marketplace.
    1. Chuyển đến thẻ Số liệu phân tích.
    2. Nhập mã Google Analytics của bạn.
    3. Nhấp vào Lưu.

Chế độ cài đặt cấu hình ứng dụng

Tài liệu tham khảo sau mô tả các chế độ cài đặt có trên trang Cấu hình ứng dụng của SDK Google Workspace Marketplace.

Chế độ hiển thị của ứng dụng

Bạn thấy tuỳ chọn Chế độ hiển thị của ứng dụng nếu đang sử dụng tài khoản Google Workspace (tài khoản do tổ chức cơ quan hoặc trường học của bạn tạo). Nếu đang sử dụng tài khoản người dùng cá nhân (tài khoản kết thúc bằng "@gmail.com"), bạn chỉ có thể xuất bản công khai.

  • Công khai: Những người bên ngoài miền của bạn có thể tìm thấy và cài đặt ứng dụng. Nếu bạn chọn chế độ hiển thị công khai, Google sẽ xem xét và phê duyệt trang thông tin ứng dụng của bạn trước khi phát hành.
  • Riêng tư: Chỉ những người trong miền của bạn mới có thể tìm thấy và cài đặt ứng dụng của bạn.

Nếu bạn chọn phát hành ở chế độ Không công khai, trang thông tin ứng dụng sẽ không xuất hiện trong các kết quả duyệt xem hoặc tìm kiếm. Người dùng chỉ có thể truy cập vào trang cửa hàng của ứng dụng bằng URL trực tiếp.

Nếu muốn giới hạn các quốc gia và khu vực mà bạn cung cấp ứng dụng, hãy thiết lập chế độ đó trong phần Phân phối khi tạo trang thông tin trên Cửa hàng Play.

Cài đặt

Các chế độ cài đặt sẽ xác định liệu người dùng hoặc quản trị viên Workspace có thể cài đặt ứng dụng của bạn qua trang thông tin trên Cửa hàng Play trên Google Workspace Marketplace hay không.

  • Cài đặt cá nhân + Quản trị viên (mặc định): Người dùng cá nhân hoặc quản trị viên có thể cài đặt ứng dụng cho miền, đơn vị tổ chức hoặc một nhóm người dùng của họ. Các chính sách miền của người dùng có thể ngăn họ cài đặt ứng dụng ngay cả khi bạn bật các lượt cài đặt riêng lẻ.
  • Cài đặt chỉ dành cho quản trị viên: Chỉ quản trị viên mới có thể cài đặt ứng dụng cho miền, đơn vị tổ chức hoặc một nhóm người dùng của họ. Ứng dụng của bạn chỉ xuất hiện trong kết quả tìm kiếm trên Google Workspace Marketplace đối với quản trị viên và những người chưa đăng nhập vào Tài khoản Google của họ. Chọn tuỳ chọn này nếu ứng dụng của bạn yêu cầu cài đặt miền.

Tích hợp ứng dụng

Chọn những dịch vụ của Google Workspace mà ứng dụng hoặc tiện ích bổ sung của bạn tương thích, chẳng hạn như Tiện ích bổ sung của Google Workspace hoặc ứng dụng Google Chat. Bạn phải chọn ít nhất một phương án. Trong một số trường hợp, bạn có thể đưa nhiều nội dung tích hợp ứng dụng vào trang thông tin ứng dụng của mình. Xem bài viết Liệt kê các công cụ tích hợp ứng dụng cùng nhau.

Tuỳ thuộc vào việc tích hợp ứng dụng mà bạn chọn, bạn có thể cần cung cấp thêm thông tin và bật các API liên quan trong dự án Google Cloud của mình. Bảng sau đây mô tả cách thiết lập bổ sung cần thiết cho từng bước:

Tiện ích bổ sung của Google Workspace (Apps Script)

Để xuất bản một tiện ích bổ sung trên Google Workspace, bạn phải cung cấp mã triển khai của tiện ích bổ sung đó. Để tìm mã triển khai, hãy làm theo các bước sau:

  1. Mở Tiện ích bổ sung dành cho Google Workspace trong trình chỉnh sửa Apps Script.
  2. Nhấp vào Triển khai > Quản lý quy trình triển khai.
  3. Trong mục mã triển khai, hãy nhấp vào Sao chép.

Tiện ích bổ sung của Google Workspace (Thời gian chạy thay thế)

Nếu bạn tạo Tiện ích bổ sung Google Workspace bằng ngôn ngữ lập trình không phải là Google Apps Script, hãy làm theo các bước sau để lấy mã triển khai từ tài nguyên triển khai Google Cloud.

  1. Trên trang Cấu hình ứng dụng trong phần "Tiện ích bổ sung của Google Workspace", hãy nhấp vào Triển khai bằng tài nguyên triển khai trên đám mây > Chọn Triển khai.
  2. Chọn phiên bản triển khai bạn muốn xuất bản.
  3. Nhấp vào Chọn.

Tiện ích bổ sung dành cho Trình chỉnh sửa (Tài liệu, Trang tính, Trang trình bày, Biểu mẫu)

Để xuất bản Tiện ích bổ sung trình chỉnh sửa, bạn phải cung cấp mã tập lệnh dự án và phiên bản mà bạn muốn phát hành.

Để tìm mã tập lệnh của dự án, hãy làm theo các bước sau:

  1. Mở tiện ích bổ sung trong trình chỉnh sửa Apps Script.
  2. Ở bên trái, hãy nhấp vào Cài đặt dự án .
  3. Trong phần "Mã nhận dạng", hãy sao chép mã tập lệnh.

Để tìm phiên bản, hãy làm theo các bước sau:

  1. Mở tiện ích bổ sung trong trình chỉnh sửa Apps Script.
  2. Ở trên cùng bên phải, hãy nhấp vào Triển khai > Quản lý hoạt động triển khai.
  3. Số phiên bản nằm trong phần "Cấu hình".

Ứng dụng Google Chat

Để phát hành ứng dụng Google Chat, bạn phải định cấu hình API Google Chat. Xem phần Phát hành ứng dụng.

Ứng dụng Drive

Để phát hành ứng dụng Drive, bạn phải bật và định cấu hình API Drive.

Ứng dụng web

Để phát hành một ứng dụng web, bạn phải cung cấp URL điều hướng chung của ứng dụng đó, URL trỏ đến ứng dụng web từ trình đơn ứng dụng Google . Ứng dụng web của bạn phải đang hoạt động chính thức và có đầy đủ chức năng.

Khi điền vào trang thông tin trên Cửa hàng Play, bạn phải cung cấp thêm biểu tượng có kích thước 96x96 và 48x48 pixel.

Nếu bạn tạo ứng dụng web trong Apps Script, để lấy URL điều hướng chung, hãy làm theo các bước sau:

  1. Mở Tiện ích bổ sung dành cho Google Workspace trong trình chỉnh sửa Apps Script.
  2. Nhấp vào Triển khai > Phiên bản triển khai mới.
  3. Trong phần "Chọn loại", hãy nhấp vào Ứng dụng web.
  4. Điền vào các lựa chọn rồi nhấp vào Deploy (Triển khai).
  5. Nhấp vào Sao chép.

Phạm vi OAuth

Cung cấp danh sách đầy đủ các phạm vi OAuth mà ứng dụng của bạn yêu cầu. Các phạm vi OAuth mà bạn nhập ở đây phải khớp với nội dung bạn hiển thị trong màn hình xin phép OAuth và tệp kê khai Apps Script (nếu có).

Nếu bạn tích hợp nhiều ứng dụng, hãy nhớ thêm các phạm vi từ mỗi ứng dụng vào trang Cấu hình ứng dụng SDK Google Workspace Marketplace và màn hình xin phép bằng OAuth.

Luôn sử dụng phạm vi hẹp nhất có thể (ví dụ: không thêm toàn bộ phạm vi Drive nếu bạn chỉ cần phạm vi chỉ có thể đọc).

Đối với các dự án Apps Script, hãy xem phần Phạm vi để biết thêm thông tin chi tiết.

Thông tin về nhà phát triển

Các trường này xuất hiện trên trang trang thông tin trên Cửa hàng Play của ứng dụng.

Các trường
Trạng thái của bên giao dịch

Theo luật bảo vệ người tiêu dùng, người tiêu dùng tại Khu vực kinh tế Châu Âu (EEA) phải được thông báo để xác định người bán trên Google Workspace Marketplace là người bán hay không phải người bán:

  • Thương nhân – Người bán là người hoạt độ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 người bán.
  • phi thương mại – Phi thương mại (người tiêu dùng) là những người hoạt động vì mục đích không chuyên nghiệp.

Nếu chưa chỉ định, "Trạng thái thương mại chưa được chỉ đị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.

Địa chỉ gửi thư của nhà phát triển

Bắt buộc đối với người bán. Không được thu thập cho người bán không phải người bán.

Vị trí doanh nghiệp của bạn. Hãy nhập một địa chỉ gửi thư hợp lệ để chúng tôi có thể liên hệ với bạn.

Tên nhà phát triển Tên để hiển thị với tư cách là tác giả của ứng dụng. Nếu bạn là người bán, hãy cung cấp tên giao dịch hoặc tên hợp pháp của bạn.
URL trang web dành cho nhà phát triển Trang web mô tả bạn (hoặc tổ chức của bạn) là nhà phát triển.
Email của nhà phát triển

Địa chỉ email để liên hệ. Dữ liệu này không có trong trang thông tin ứng dụng của bạn. Hãy đảm bảo rằng bạn luôn cập nhật địa chỉ email này — địa chỉ email này được sử dụng:

  • Nếu Google cần liên hệ với nhà phát triển, ví dụ như trong quá trình xem xét ứng dụng.
  • Gửi phản hồi từ tiện ích bổ sung Trình chỉnh sửa nếu bạn không cung cấp URL báo cáo vấn đề trên trang thông tin trên Cửa hàng Play.
URL của trang web của ứng dụng Không bắt buộc. Trang web mô tả thêm về ứng dụng của bạn.