Để xem danh sách phương thức cho tài nguyên này, hãy xem phần cuối trang này.
Biểu thị tài nguyên
Tài nguyên Doanh nghiệp đại diện cho mối liên kết giữa một EMM và một tổ chức cụ thể. Bạn có thể tạo bản sao liên kết đó theo một trong hai cách sau bằng cách sử dụng API này:
- Đối với khách hàng có miền do Google quản lý, quy trình này bao gồm việc sử dụng
Enterprises.enrollvàEnterprises.setAccount(kết hợp với các cấu phần phần mềm thu được từ Bảng điều khiển dành cho quản trị viên và Google API Console) và gửi đến EMM thông qua một quy trình thủ công. - Đối với khách hàng sử dụng Tài khoản Google được quản lý, quy trình này bao gồm việc sử dụng
Enterprises.generateSignupUrlvàEnterprises.completeSignupkết hợp với giao diện người dùng đăng ký Tài khoản Google được quản lý (cơ chế do Google cung cấp) để tạo liên kết mà không cần các bước thủ công.
{
"kind": "androidenterprise#enterprise",
"id": string ,
"primaryDomain": string ,
"name": string ,
"administrator": [
{
"email": string
}
],
"enterpriseType": string ,
"managedGoogleDomainType": string
}| Tên tài sản | Giá trị | Mô tả | Ghi chú |
|---|---|---|---|
administrator[] |
list |
Quản trị viên của doanh nghiệp. Tính năng này chỉ được hỗ trợ cho các doanh nghiệp được tạo thông qua quy trình do EMM khởi tạo. |
|
administrator[].email |
string |
Địa chỉ email của quản trị viên. | |
enterpriseType |
string |
Loại hình doanh nghiệp.
Các giá trị được chấp nhận là:
|
|
id |
string |
Mã nhận dạng duy nhất của doanh nghiệp. |
|
kind |
string |
||
managedGoogleDomainType |
string |
Loại miền Google được quản lý
Các giá trị được chấp nhận là:
|
|
name |
string |
Tên của doanh nghiệp, ví dụ: "Ví dụ, Inc". | |
primaryDomain |
string |
Miền chính của doanh nghiệp, chẳng hạn như "example.com". |
Phương thức
- acknowledgeNotificationSet
- Xác nhận các thông báo đã nhận được từ Enterprises.PullNotificationSet để ngăn các lệnh gọi tiếp theo trả về cùng một thông báo.
- completeSignup
- Hoàn tất quy trình đăng ký bằng cách chỉ định mã thông báo Hoàn tất và mã thông báo Doanh nghiệp. Bạn không được gọi yêu cầu này nhiều lần cho một Mã thông báo doanh nghiệp nhất định.
- createWebToken
- Trả về một mã thông báo duy nhất để truy cập vào giao diện người dùng có thể nhúng. Để tạo giao diện người dùng web, hãy truyền mã thông báo đã tạo vào API JavaScript của Google Play được quản lý. Mỗi mã thông báo chỉ có thể được dùng để bắt đầu một phiên giao diện người dùng. Hãy xem tài liệu về API JavaScript để biết thêm thông tin.
- đăng ký
- Đăng ký một doanh nghiệp với EMM gọi.
- generateSignupUrl
- Tạo URL đăng ký.
- get
- Truy xuất tên và miền của một doanh nghiệp.
- getServiceAccount
- Trả về một tài khoản dịch vụ và thông tin xác thực. Bạn có thể liên kết tài khoản dịch vụ với doanh nghiệp bằng cách gọi setAccount. Tài khoản dịch vụ là duy nhất cho doanh nghiệp và EMM này, đồng thời sẽ bị xoá nếu doanh nghiệp bị huỷ liên kết. Thông tin xác thực chứa dữ liệu khoá riêng tư và không được lưu trữ ở phía máy chủ.
Bạn chỉ có thể gọi phương thức này sau khi gọi Enterprises.Enroll hoặc Enterprises.CompleteSignup và trước khi gọi Enterprises.SetAccount; nếu không, phương thức này sẽ trả về lỗi.
Các lệnh gọi tiếp theo sau lệnh gọi đầu tiên sẽ tạo một bộ thông tin xác thực mới, duy nhất và vô hiệu hoá thông tin xác thực đã tạo trước đó.
Sau khi liên kết tài khoản dịch vụ với doanh nghiệp, bạn có thể quản lý tài khoản dịch vụ đó bằng cách sử dụng tài nguyên serviceAccountKeys. - getStoreLayout
- Trả về bố cục cửa hàng cho doanh nghiệp. Nếu bạn chưa đặt bố cục cửa hàng, thì hệ thống sẽ trả về "cơ bản" làm loại bố cục cửa hàng và không có trang chủ.
- list
- Tìm kiếm một doanh nghiệp theo tên miền. Tính năng này chỉ được hỗ trợ cho các doanh nghiệp được tạo thông qua quy trình tạo do Google khởi tạo. Bạn không cần tra cứu mã nhận dạng cho các doanh nghiệp được tạo thông qua quy trình do EMM khởi tạo vì EMM sẽ tìm hiểu mã nhận dạng doanh nghiệp trong lệnh gọi lại được chỉ định trong lệnh gọi Enterprises.generateSignupUrl.
- pullNotificationSet
- Kéo và trả về một nhóm thông báo cho các doanh nghiệp được liên kết với tài khoản dịch vụ đã được xác thực cho yêu cầu. Tập hợp thông báo có thể trống nếu không có thông báo nào đang chờ xử lý.
Bạn cần xác nhận một tập hợp thông báo được trả về trong vòng 20 giây bằng cách gọi Enterprises.AcknowledgeNotificationSet, trừ khi tập hợp thông báo đó trống.
Các thông báo không được xác nhận trong vòng 20 giây cuối cùng sẽ được đưa vào lại trong phản hồi cho một yêu cầu PullNotificationSet khác, còn những thông báo không bao giờ được xác nhận cuối cùng sẽ bị xoá theo chính sách hệ thống Pub/Sub của Google Cloud Platform.
Nhiều yêu cầu có thể được thực hiện đồng thời để truy xuất thông báo. Trong trường hợp đó, các thông báo đang chờ xử lý (nếu có) sẽ được phân chia giữa từng phương thức gọi, nếu có thông báo đang chờ xử lý.
Nếu không có thông báo nào, hệ thống sẽ trả về danh sách thông báo trống. Các yêu cầu tiếp theo có thể trả về thêm thông báo khi có. - sendTestPushNotification
- Gửi thông báo thử nghiệm để xác thực việc tích hợp EMM với dịch vụ Google Cloud Pub/Sub cho doanh nghiệp này.
- setAccount
- Đặt tài khoản sẽ được dùng để xác thực với API dưới dạng doanh nghiệp.
- setStoreLayout
- Đặt bố cục cửa hàng cho doanh nghiệp. Theo mặc định, storeLayoutType được đặt thành "basic" (cơ bản) và bố cục cửa hàng cơ bản được bật. Bố cục cơ bản chỉ chứa các ứng dụng được quản trị viên phê duyệt và đã được thêm vào nhóm sản phẩm có sẵn cho người dùng (bằng lệnh gọi setAvailableProductSet). Các ứng dụng trên trang được sắp xếp theo thứ tự giá trị mã sản phẩm. Nếu bạn tạo bố cục cửa hàng tuỳ chỉnh (bằng cách đặt storeLayoutType = "custom" và đặt trang chủ), thì bố cục cửa hàng cơ bản sẽ bị vô hiệu hoá.
- huỷ đăng ký
- Huỷ đăng ký một doanh nghiệp khỏi EMM gọi.