Đị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 trên Google Workspace Marketplace để định cấu hình và quản lý trên Google Workspace Marketplace.

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

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

Bất kể bạn đang xuất bản ứng dụng của bạn một cách công khai hoặc riêng tư, thì bạn phải sử dụng SDK của Google Workspace Marketplace để quản lý trên Marketplace.

Bật SDK của Google Workspace Marketplace

Trong dự án Google Cloud, nếu bạn chưa làm việc này, bật SDK Google Workspace Marketplace:

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 đang đã mở, hãy nhấp vào tên dự án trên đám mây để chuyển đổi Dự án trên đám mây.
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 của Google Workspace Marketplace.

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

Xác định chế độ cài đặt cấu hình cho ứng dụng

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

Chọn người có thể xem và cài đặt ứng dụng của bạn

Khi định cấu hình ứng dụng, bạn sẽ chỉ định những người dùng có thể truy cập vào ứng dụng đó bằng cách sử dụng các chế độ cài đặt sau:

• Chế độ hiển thị của ứng dụng: Nếu bạn đang xuất bản ứng dụng trong tổ chức trên Google Workspace, cho dù trang thông tin ứng dụng của bạn ở chế độ không công khai, hiển thị với tất cả người dùng trong tổ chức của bạn hoặc bất kỳ ai sử dụng Google Workspace.
• Chế độ cài đặt: Liệu ứng dụng có thể chỉ có thể do quản trị viên Google Workspace cài đặt.

Bất kể bạn chỉ định chế độ cài đặt nào trong trang thông tin ứng dụng, người dùng thuộc mà một tổ chức sử dụng Google Workspace có thể không tìm thấy, cài đặt, hoặc dùng ứng dụng của bạn dựa trên các chế độ cài đặt do quản trị viên của họ thiết lập. Quản trị viên có thể ảnh hưởng đến phạm vi cung cấp của ứng dụng theo những cách sau:

• Kiểm soát xem người dùng của họ có thể xem ứng dụng trong Marketplace và cài đặt các ứng dụng thay mặt cho người dùng.
• Sử dụng danh sách cho phép để quản lý và tuyển chọn ứng dụng cho tổ chức của họ. Nếu bạn đang phát triển ứng dụng cho một tổ chức sử dụng danh sách cho phép, hãy liên hệ với quản trị viên về việc thêm ứng dụng vào danh sách cho phép.
• Tắt một số ứng dụng của Google Workspace, chẳng hạn như xoá quyền truy cập vào ứng dụng Google Chat, Google Chat hoặc cả hai. Trong những trường hợp này, người dùng sẽ không thể cài đặt ứng dụng của bạn từ Thị trường.

Để tìm hiểu cách quản trị viên quản lý quyền truy cập vào Marketplace, hãy xem Tài liệu trợ giúp dành cho quản trị viên Marketplace

Cài đặt chế độ hiển thị ứng dụng

Bạn sẽ thấy tuỳ chọn Chế độ hiển thị của ứng dụng nếu đang sử dụng Google Workspace tài khoản (tài khoản do tổ chức cơ quan hoặc trường học của bạn tạo). Nếu bạn bằ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 tổ chức của bạn có thể tìm thấy và cài đặt ứng dụng miền. Nếu bạn chọn chế độ hiển thị công khai, Google sẽ xem xét và phê duyệt ứng dụng của bạn trước khi xuất bản.
• Riêng tư: Chỉ những người trong miề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 xuất bản ở chế độ Không công khai, thì trang thông tin ứng dụng sẽ không xuất hiện trong phần duyệt qua hoặc kết quả tìm kiếm. Người dùng chỉ có thể truy cập trang cửa hàng của ứng dụng bằng phương thức URL.

Nếu muốn giới hạn phạm vi cung cấp ứng dụng ở những quốc gia và khu vực nào, bạn thiết lập điều đó 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ách cài đặt ứng dụng

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

• Cài đặt cá nhân + Quản trị viên (mặc định): Có thể cài đặt ứng dụng bằng người dùng cá nhân hoặc quản trị viên đối với miền, đơn vị tổ chức hoặc nhóm người dùng. Chính sách miền của người dùng có thể ngăn họ cài đặt một ứng dụng ngay cả khi bạn đã bật từng 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 này cho miền, đơn vị tổ chức hoặc nhóm người dùng. Ứ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 dành cho quản trị viên và những người chưa đăng nhập vào Tài khoản Google của mình. Chọn cách này nếu ứng dụng của bạn yêu cầu cài đặt miền.

Các chế độ cài đặt và hiển thị phổ biến

Bảng sau đây tóm tắt một số tuỳ chọn cấu hình ứng dụng phổ biến cho cài đặt và hiển thị:

Người dùng ứng dụng dự kiến	Chế độ cài đặt Chế độ hiển thị ứng dụng	Chế độ cài đặt Cài đặt ứng dụng	Ai có thể cài đặt ứng dụng của tôi?	Ai có thể sử dụng ứng dụng của tôi?
Đối với các ứng dụng dành riêng cho tổ chức trên Google Workspace
Những người dùng cụ thể trong tổ chức của bạn	Riêng tư và Không công khai	Cài đặt riêng lẻ + Quản trị viên	Bất kỳ ai trong tổ chức của bạn có URL trang thông tin ứng dụng (nếu được phép).	Bất kỳ ai trong tổ chức của bạn có URL trang thông tin ứng dụng (nếu được phép).
Tổ chức của bạn	Riêng tư	Cài đặt riêng lẻ + Quản trị viên	Bất kỳ ai trong tổ chức của bạn, nếu được cho phép.	Bất kỳ ai trong tổ chức của bạn, nếu được cho phép.
Tổ chức của bạn	Riêng tư	Chỉ quản trị viên	Quản trị viên	Người dùng đã cài đặt ứng dụng do quản trị viên của họ cài đặt.
Đối với những ứng dụng dành cho người dùng bên ngoài một tổ chức Google Workspace cụ thể
Người dùng trong tổ chức sử dụng Google Workspace	Công khai	Chỉ quản trị viên	Quản trị viên	Người dùng đã cài đặt ứng dụng do quản trị viên của họ cài đặt.
Tất cả người dùng Google Workspace	Công khai	Cài đặt riêng lẻ + Quản trị viên	Bất cứ ai sử dụng các ứng dụng trong Google Workspace cho mục đích cá nhân. Người dùng trong các tổ chức Google Workspace (nếu được phép).	Bất cứ ai sử dụng các ứng dụng trong Google Workspace cho mục đích cá nhân. Người dùng trong các tổ chức Google Workspace (nếu được phép).

Xác định cách ứng dụng của bạn tích hợp với các ứng dụng của Google Workspace

Chọn các dịch vụ của Google Workspace mà ứng dụng hoặc tiện ích bổ sung của bạn được thiết kế để để làm việc, chẳng hạn như một 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 lựa chọn. Trong một số trường hợp, bạn có thể tích hợp nhiều ứng dụng vào trang thông tin ứng dụng của mình. Xem 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 nào, 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 bạn. Nội dung sau đây bảng mô tả cách thiết lập bổ sung cần thiết cho từng mục:

Chỉ định cấp truy cập mà ứng dụng của bạn yêu cầu

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

Nếu bạn bao gồm nhiều hoạt động tích hợp ứng dụng, hãy đảm bảo bạn thêm các phạm vi từ từng truy cập vào trang Cấu hình ứng dụng SDK trên Google Workspace Marketplace và sự đồng ý OAuth của bạn màn hình.

Luôn sử dụng phạm vi hẹp nhất có thể (ví dụ: không bao gồm Phạm vi của 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ạm vi để biết thêm chi tiết.

Cung cấp thông tin về nhà phát triển ứng dụng

Trong phần Thông tin của nhà phát triển, hãy điền thông tin liên hệ và các thông tin chi tiết khác. Những trường này xuất hiện trên trang chủ trang thông tin trên Cửa hàng Play.

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 ở Châu Âu Khu vực kinh tế (EEA) phải được thông báo về việc người bán trên Google Workspace Marketplace là một người bán hoặc pháp nhân phi thương mại: Người bán – Người bán là người hành động vì mục đích liên quan đến đến một ngành thương mại, kinh doanh, thủ công hoặc ngành nghề; hoặc theo tên của hoặc trên 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 đại diện cho mục đích không chuyên nghiệp. Nếu bạn chưa chỉ định, thì "Trạng thái của người bán chưa được chỉ định" xuất hiện trên trang trang thông tin trên Cửa hàng Play .
Đị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 đối với người phi thương mại. Vị trí doanh nghiệp của bạn. Nhập một địa chỉ gửi thư hợp lệ có thể liên hệ được.
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 là người bán, cung cấp tên giao dịch hoặc tên pháp lý 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 nhà phát triển	Địa chỉ email để dùng làm đầu mối liên hệ. Bây giờ không được đưa vào danh sách ứng dụng của bạn. Đảm bảo địa chỉ email này được cập nhật tối đa ngày—được sử dụng: Nếu Google cần liên hệ với nhà phát triển (ví dụ: trong quá trình quy trình xem xét ứng dụng. Để gửi ý kiến phản hồi qua tiện ích bổ sung Trình chỉnh sửa nếu URL báo cáo sự cố không phải là được cung cấp trên trang Danh sách cửa hàng.
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.

Lưu chế độ cài đặt cấu hình của ứng dụng trong SDK của Google Workspace Marketplace

Sử dụng thông tin từ phần trước, lưu cấu hình của ứng dụng trong SDK của Google Workspace Marketplace:

1. Mở SDK Google Workspace Marketplace.
2. Chuyển tới thẻ Cấu hình ứng dụng.
3. Điền vào từng phần dựa trên nội dung bạn đã xác định trong phần trước.
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 trong SDK của Google Workspace Marketplace.
   1. Chuyển đến thẻ Số liệu phân tích.
   2. Nhập mã nhận dạng Google Analytics của bạn.
   3. Nhấp vào Lưu.