Đị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.

Để có thể sử dụng ứng dụng, bạn cần thiết lập ứng dụng đó trong Marketplace SDK. SDK 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 Marketplace để quản lý các chế độ cài đặt Marketplace, chẳng hạn như:

• Liệu ứng dụng của bạn có dành cho một tổ chức Google Workspace cụ thể (ứng dụng riêng tư) hay dành cho tất cả người dùng Marketplace (ứng dụng công khai)
• Các loại 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 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 tạo và duy trì ứng dụng

Bất kể bạn phát hành ứng dụng ở chế độ riêng tư hay công khai, bạn đều phải sử dụng SDK Marketplace để quản lý ứng dụng trên Marketplace.

Bật SDK Marketplace

Nếu bạn chưa bật, hãy bật Google Workspace Marketplace SDK trong dự án Google Cloud.

Mở dự án trên Google Cloud trong Google Cloud Console

Nếu chưa mở, hãy mở dự án trên Google Cloud mà bạn dự định sử dụng cho mẫu này:

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Chọn dự án.

   Chọn một dự án trên Đám mây

2. Chọn dự án Google Cloud mà bạn muốn sử dụng. Hoặc nhấp vào Tạo dự án rồi làm theo hướng dẫn trên màn hình. Nếu tạo một dự án trên Google Cloud, có thể bạn sẽ phải bật tính năng thanh toán cho dự án đó.

Bật SDK Google Workspace Marketplace

Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.

• Trong Google Cloud Console, hãy bật SDK Google Workspace Marketplace.

  Bật SDK

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 trang Cấu hình ứng dụng của SDK 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 chỉ định những người dùng có thể truy cập vào ứng dụng bằng các chế độ cài đặt sau:

• Mức độ hiển thị ứng dụng: Nếu bạn đang phát hành một ứng dụng trong một tổ chức Google Workspace, thì trang thông tin ứng dụng của bạn có bị ẩn, hiển thị cho tất cả người dùng trong tổ chức của bạn hay cho bất kỳ ai sử dụng Google Workspace.
• Chế độ cài đặt cài đặt: Liệu chỉ quản trị viên Google Workspace mới có thể cài đặt ứng dụng hay không.

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

• Kiểm soát việc người dùng của họ có thể xem ứng dụng trong Trang web thương mại và cài đặt ứng dụng thay mặt cho người dùng hay khô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 một ứng dụng cho một tổ chức sử dụng danh sách cho phép, hãy hỏ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 Google Workspace, chẳng hạn như xoá quyền truy cập vào Google Chat, các ứng dụng 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ừ Marketplace.

Để 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.

Chế độ cài đặt chế độ hiển thị của ứng dụng

Bạn sẽ thấy tuỳ chọn Mức độ hiển thị ứ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 xuất bản.
• Riêng tư: Chỉ những người trong miền của bạn mới có thể tìm và cài đặt ứng dụng của bạn.

Nếu bạn chọn xuất bản dưới dạng Không được liệt kê, trang thông tin ứng dụng sẽ không xuất hiện trong kết quả duyệt xem hoặc kết quả 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 những quốc gia và khu vực mà ứng dụng của bạn có mặt, bạn có thể thiết lập thông tin đó 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ài đặt ứng dụng

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

• Cá nhân + Cài đặt quản trị (mặc định): Ứng dụng có thể được cài đặt bởi người dùng cá nhân hoặc quản trị viên cho miền, đơn vị tổ chức hoặc một 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 ứng dụng ngay cả khi bạn bật chế độ cài đặt riêng lẻ.
• Chỉ quản trị viên mới có thể cài đặt: 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. Ứ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.

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

Bảng sau đây tóm tắt một số tuỳ chọn cấu hình ứng dụng phổ biến để 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ị của ứ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 ứng dụng được tạo cho một tổ chức 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 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ỉ dành cho quản trị viên	Quản trị viên	Người dùng do quản trị viên cài đặt ứng dụng.
Đối với ứng dụng mà người dùng bên ngoài một tổ chức Google Workspace cụ thể có thể sử dụng
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 do quản trị viên cài đặt ứng dụng.
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 kỳ ai sử dụng các ứng dụng của Google Workspace cho mục đích cá nhân. Người dùng trong các tổ chức dùng Google Workspace (nếu được phép).	Bất kỳ ai sử dụng các ứng dụng của 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ụ Google Workspace mà ứng dụng hoặc tiện ích bổ sung của bạn được thiết kế để hoạt động cùng, chẳng hạn như Tiện ích bổ sung Google Workspace hoặc ứng dụng Google Chat. Bạn phải chọn ít nhất một tuỳ chọn. Trong một số trường hợp, bạn có thể đưa nhiều tính năng tích hợp ứng dụng vào trang thông tin ứng dụng. Xem phần Liệt kê các công cụ tích hợp ứng dụng cùng nhau.

Tuỳ thuộc vào chế độ 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 có liên quan trong dự án Google Cloud của mình. Bảng sau đây mô tả chế độ thiết lập bổ sung cần thiết cho từng loại:

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 2.0 mà ứng dụng của bạn yêu cầu. Phạm vi OAuth mà bạn nhập tại đây phải khớp với phạm vi mà bạn hiển thị trong màn hình đồng ý 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 của từng ứng dụng vào trang Cấu hình ứng dụng SDK của Marketplace và màn hình đồng ý OAuth.

Luôn sử dụng phạm vi hẹp nhất có thể (ví dụ: không thêm phạm vi đầy đủ trên 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 uỷ quyền để 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 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 trang thông tin trên Cửa hàng Play của ứng dụng.

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 ở 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: 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 một người bán. Phi thương mại: 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.
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 pháp lý của bạn.
Địa chỉ gửi thư của nhà phát triển	Bắt buộc đối với người giao dịch. Không thu thập đối với người không phải người kinh doanh. Vị trí của doanh nghiệp. Nhập địa chỉ gửi thư hợp lệ để chúng tôi có thể liên hệ với bạn.
URL của 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 dùng làm đầu mối liên hệ. Thông tin này không có trong trang thông tin ứng dụng của bạn. Hãy đảm bảo rằng địa chỉ email này luôn được cập nhật vì địa chỉ này được dùng để: Nếu Google cần liên hệ với nhà phát triển, ví dụ: trong quá 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 bạn không cung cấp URL báo cáo vấn đề tại trang thông tin trên Cửa hàng Play.
URL của trang web ứ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 ứng dụng trong SDK Marketplace

Sử dụng thông tin trong phần trước, hãy lưu cấu hình ứng dụng của bạn trong SDK Marketplace:

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Cấu hình SDK Marketplace:

   Chuyển đến trang Cấu hình SDK của Marketplace

2. Đ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.

3. Nhấp vào Lưu.

4. (Không bắt buộc) Bạn có thể nhận số liệu phân tích về mức sử dụng ứng dụng trong Google Analytics. Để thực hiện việc này, hãy thêm mã Google Analytics trong SDK Thị trường.

   1. Chuyển đến thẻ Số liệu phân tích.
   2. Nhập mã nhận dạng của bạn trên Google Analytics.
   3. Nhấp vào Lưu.