Trang này giải thích cách sử dụng Google Workspace Marketplace SDK để định cấu hình và quản lý ứng dụng của bạn trên Google Workspace Marketplace.
Để người dùng có thể sử dụng ứng dụng của bạn, bạn cần thiết lập ứng dụng đó trong Marketplace SDK. Marketplace SDK 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 Marketplace. Bạn sử dụng Marketplace SDK để quản lý các chế độ cài đặt của Marketplace, chẳng hạn như:
- Ứ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
- (Các) ứng dụng Google Workspace mà ứng dụng của bạn tích hợp
- Các 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 xuất bản ứng dụng ở chế độ riêng tư hay công khai, bạn đều phải sử dụng Marketplace SDK để quản lý ứng dụng của mình trên Marketplace.
Bật Marketplace SDK
Nếu bạn chưa làm việc này, hãy bật Marketplace SDK trong dự án Google Cloud.
Mở dự án trên Cloud trong Google Cloud Console
Nếu chưa mở, hãy mở dự án trên Cloud mà bạn dự định dùng cho mẫu này:
- Trong Google Cloud Console, hãy chuyển đến trang Chọn một dự án.
- Chọn dự án trong 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, bạn có thể cần bật tính năng thanh toán cho dự án đó.
Bật Marketplace SDK
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 Google Workspace Marketplace SDK.
Xác định chế độ cài đặt cấu hình cho ứng dụng của bạn
Thông tin tham khảo sau đây mô tả các chế độ cài đặt có trên trang Cấu hình ứng dụng của Marketplace SDK.
Chọn những 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 của bạn bằng các chế độ cài đặt sau:
- Mức độ hiển thị của ứng dụng: Nếu bạn đang xuất bản một ứng dụng trong một tổ chức Google Workspace, thì danh sách ứng dụng của bạn sẽ ở trạng thái không công khai, hiển thị cho 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 khi cài đặt: Ứng dụng có chỉ được cài đặt bởi quản trị viên Google Workspace hay không.
Bất kể chế độ cài đặt mà bạn chỉ định trong trang thông tin ứng dụng, nhữ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. Quản trị viên có thể ảnh hưởng đến phạm vi cung cấp ứng dụng của bạn theo những cách sau:
- Kiểm soát việc người dùng có thể xem ứng dụng trên Marketplace và cài đặt ứng dụng thay 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 các ứng dụng cho tổ chức của mình. Nếu bạn đang phát triển một ứng dụng cho 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 khả năng hiển thị của ứng dụng
Bạn sẽ thấy lựa chọn Chế độ 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 nơi bạn làm việc hoặc trường học tạo). Nếu đang sử dụng tài khoản người dùng cá nhân (tài khoản có đuôi "@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ày. 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 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, trang thông tin ứng dụng sẽ không xuất hiện trong 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 những quốc gia và khu vực mà bạn cung cấp ứng dụng, bạn có thể thiết lập trong phần Phân phối khi tạo trang thông tin trên Cửa hàng Play.
Chế độ cài đặt cài đặt ứng dụng
Lựa chọn Chế độ cài đặt khi 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 của bạn trên Cửa hàng Play trên Marketplace hay không.
- Cài đặt cho 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 này cho miền, đơn vị tổ chức hoặc một nhóm người dùng. Các 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 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 này 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 lựa 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ề việc cài đặt và chế độ hiển thị
Bảng sau đây tóm tắt một số lựa 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 mục tiêu | Chế độ cài đặt Khả năng 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 các ứng dụng được tạo cho một tổ chức sử dụng Google Workspace | |||||
| Một số 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 cho cá nhân + Quản trị viên | Nếu được phép, bất cứ 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 cứ ai trong tổ chức của bạn có URL trang thông tin ứng dụng. | |
| Tổ chức của bạn | Riêng tư | Cài đặt cho cá nhân + Quản trị viên | Nếu được phép, 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. | |
| 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 này thông qua quản trị viên. | |
| Đối với những ứ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 các tổ chức 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 này thông qua quản trị viên. | |
| Tất cả người dùng Google Workspace | Công khai | Cài đặt cho cá nhân + Quản trị viên |
|
|
|
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ế để hoạt động cùng, 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 lựa chọn. Trong một số trường hợp, bạn có thể thêm 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 những 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 trường hợp:
Tiện ích bổ sung của Google Workspace
Để xuất bản một tiện ích bổ sung của Google Workspace, bạn phải cung cấp mã nhận dạng triển khai của tiện ích bổ sung đó.
Để tìm mã nhận dạng triển khai trong Apps Script, hãy làm theo các bước sau:
- Mở tiện ích bổ sung Google Workspace trong trình chỉnh sửa Apps Script.
- Nhấp vào Triển khai > Quản lý các phiên bản triển khai.
- Bên dưới mã hoạt động triển khai, hãy nhấp vào Sao chép.
Để tìm mã nhận dạng triển khai cho một tiện ích bổ sung HTTP, hãy làm theo các bước sau:
- Trên trang Cấu hình ứng dụng trong phần "Tiện ích bổ sung cho Google Workspace", hãy nhấp vào HTTP hoặc các lượt triển khai khác > Chọn Triển khai.
- Chọn bản triển khai mà bạn muốn xuất bản.
- 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 một tiện ích bổ sung cho Trình chỉnh sửa, bạn phải cung cấp mã nhận dạng tập lệnh dự án và phiên bản mà bạn muốn xuất bản.
Để tìm mã tập lệnh dự án, hãy làm theo các bước sau:
- Mở tiện ích bổ sung trong trình chỉnh sửa Apps Script.
- Ở bên trái, hãy nhấp vào Cài đặt dự án .
- Trong mục "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:
- Mở tiện ích bổ sung trong trình chỉnh sửa Apps Script.
- Ở trên cùng bên phải, hãy nhấp vào Triển khai > Quản lý việc triển khai.
- Số phiên bản nằm trong phần "Cấu hình".
Ứng dụng Google Chat
Để xuất bản một ứng dụng Google Chat có tính tương tác, hãy xem tài liệu sau:
- Nếu tạo ứng dụng Chat dưới dạng một tiện ích bổ sung, bạn phải định cấu hình chế độ cài đặt tiện ích bổ sung trong Chat API. Để biết các bước, hãy xem phần Định cấu hình ứng dụng Chat trong tài liệu về tiện ích bổ sung Google Workspace.
- Nếu tạo ứng dụng Chat bằng các sự kiện tương tác, bạn phải định cấu hình chế độ cài đặt sự kiện tương tác trong Chat API. Để biết các bước, hãy xem phần Nhận và phản hồi các sự kiện tương tác trong tài liệu về Chat API.
- Nếu bạn tạo ứng dụng Chat bằng chế độ định cấu hình tự động của AppSheet, hãy xuất bản ứng dụng Chat bằng các bước được mô tả trong tài liệu của AppSheet, Chia sẻ ứng dụng Chat bằng chế độ định cấu hình tự động.
Ứng dụng Drive
Để xuất bản một ứng dụng Drive, bạn phải bật và định cấu hình API Google Drive.
Ứng dụng web
Để xuất bản một ứng dụng web, bạn phải cung cấp URL điều hướng chung của ứng dụng đó, tức là URL trỏ đến ứng dụng web từ trình đơn ứng dụng của Google . Ứng dụng web của bạn phải đang được phát hành công khai và hoạt động đầy đủ.
Khi điền thông tin vào trang Thông tin trên Cửa hàng Play, bạn phải cung cấp các biểu tượng bổ sung có kích thước 96x96 và 48x48 pixel.
Nếu bạn tạo ứng dụng web trong Apps Script, hãy làm theo các bước sau để lấy URL điều hướng chung:
- Mở tiện ích bổ sung Google Workspace trong trình chỉnh sửa Apps Script.
- Nhấp vào Triển khai > Triển khai mới.
- Trong phần "Chọn loại", hãy nhấp vào Ứng dụng web.
- Điền thông tin vào các lựa chọn rồi nhấp vào Triển khai.
- Nhấp vào Sao chép.
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 ở đây phải khớp với phạm vi bạn hiển thị trong màn hình đồng ý OAuth và nếu có, tệp kê khai Apps Script.
Nếu bạn đưa nhiều chế độ tích hợp ứng dụng vào, hãy nhớ thêm các phạm vi của từng chế độ vào trang Cấu hình ứng dụng của SDK Thị trường 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 đủ của Drive nếu bạn chỉ cần phạm vi chỉ đọ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 thông tin.
Cung cấp thông tin về nhà phát triển ứng dụng
Trong phần Thông tin về nhà phát triển, hãy điền thông tin liên hệ và các thông tin khác. 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.
| 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 liệu người bán trên Trang web thương mại là bên giao dịch hay không phải bên giao dịch:
Nếu bạn không chỉ định, thì "Trạng thái người bán không xác đị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. |
| Tên nhà phát triển | Tên hiển thị của tác giả ứ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 nhà giao dịch. Không thu thập đối với pháp nhân 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ệ để 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) trong vai trò là nhà phát triển. |
| Email của nhà phát triển |
Địa chỉ email dùng làm thông tin liên hệ. Thông tin này không có trong trang thông tin của ứng dụng. Hãy nhớ cập nhật địa chỉ email này vì địa chỉ này được dùng để:
|
| 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 Marketplace SDK
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 Marketplace SDK:
Trong Bảng điều khiển Google Cloud, hãy chuyển đến trang Cấu hình ứng dụng của Marketplace SDK:
Điền vào từng phần dựa trên những gì bạn đã xác định trong phần trước.
Nhấp vào Lưu bản nháp.
(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. Để làm như vậy, hãy thêm mã Google Analytics vào Marketplace SDK.
- Chuyển đến thẻ Số liệu phân tích.
- Nhập mã nhận dạng Google Analytics của bạn.
- Nhấp vào Lưu.
Khắc phục sự cố
Phần này mô tả các vấn đề thường gặp mà bạn có thể gặp phải.
Thiếu các quyền bắt buộc khi xuất bản ứng dụng lên Marketplace
Bạn không thể xuất bản ứng dụng trên Marketplace vì các nỗ lực định cấu hình ứng dụng trên trang Cấu hình ứng dụng của Marketplace SDK đều thất bại với thông báo lỗi sau:
You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update
Lỗi này xảy ra khi bạn bật API Marketplace SDK và khi sử dụng một vai trò IAM khác ngoài Editor hoặc Owner.
Để giải quyết lỗi này, hãy triển khai một trong các giải pháp sau:
Yêu cầu chủ sở hữu dự án chỉ định vai trò
roles/appmetadata.workspaceMarketplaceAppConfigurationAdmincho tài khoản thiếu quyền để cho phép họ định cấu hình và quản lý ứng dụng trong Marketplace SDK.Yêu cầu chủ sở hữu dự án thêm các quyền còn thiếu vào một vai trò tuỳ chỉnh thông qua trang IAM & Admin (Quản lý danh tính và quyền truy cập & Quản trị viên) > Roles (Vai trò) trong Google Cloud Console. Sau đó, hãy chỉ định vai trò tuỳ chỉnh cho tài khoản thiếu quyền.
Bạn có thể dùng
roles/editorhoặcroles/ownernguyên thuỷ để xuất bản ứng dụng. Tuy nhiên, tài liệu Sử dụng IAM một cách an toàn coi đây là một phương pháp không hay vì người dùng không thể dễ dàng hạn chế quyền chỉnh sửa đối với các tài nguyên khác trong dự án.