Lưu ý quan trọng: Chúng tôi không còn chấp nhận các lượt đăng ký mới cho Play EMM API. Tìm hiểu thêm.

Trang này được dịch bởi Cloud Translation API.

Enterprises

Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Tài nguyên dành cho doanh nghiệp đại diện cho sự liên kết giữa một EMM và một tổ chức cụ thể. Bạn có thể tạo thực thể liên kết đó theo một trong hai cách bằng cách sử dụng API này như sau:

Đối với khách hàng sử dụng miền do Google quản lý, quy trình này sẽ bao gồm việc sử dụng Enterprises.enroll và Enterprises.setAccount (cùng với các cấu phần phần mềm lấy được từ Bảng điều khiển dành cho quản trị viên và Bảng điều khiển API của Google) rồi gửi đến EMM thông qua một quy trình thủ công (ít hơn hoặc nhiều hơn).
Đối với những khách hàng sử dụng Tài khoản Google Play được quản lý, quy trình này bao gồm việc sử dụng Enterprises.generateSignupUrl và Enterprises.completeSignup cùng với giao diện người dùng đăng ký Google Play được quản lý (cơ chế do Google cung cấp) để tạo mối liên kết mà không cần thực hiện các bước thủ công.

Là một EMM, bạn có thể hỗ trợ một hoặc cả hai phương pháp trong bảng điều khiển EMM của mình. Xem bài viết Tạo doanh nghiệp để biết chi tiết.

{
  "kind": "androidenterprise#enterprise",
  "id": string,
  "primaryDomain": string,
  "name": string,
  "administrator": [
    {
      "email": string
    }
  ]
}

Tên tài sản	Giá trị	Mô tả
`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.
`id`	`string`	Mã nhận dạng duy nhất của doanh nghiệp.
`kind`	`string`
`name`	`string`	Tên doanh nghiệp, ví dụ: "Example, 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 cuộc gọi tiếp theo quay lại thông báo tương tự.
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 Doanh nghiệp cụ thể Mã thông báo.
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 một giao diện người dùng web, hãy chuyển mã thông báo đã tạo vào javascript Managed Google Play API. Bạn chỉ có thể dùng mỗi mã thông báo để bắt đầu một phiên giao diện người dùng. Xem Tài liệu về API JavaScript để biết thêm thông tin.
đăng ký: Đăng ký cho doanh nghiệp sử dụng dịch vụ EMM (quản lý thiết bị di động doanh nghiệp) dành cho doanh nghiệp được gọi.
generateSignupUrl: Tạo một URL đăng ký.
nhận: Truy xuất tên và miền của doanh nghiệp.
getServiceAccount: Trả về tài khoản dịch vụ và thông tin xác thực. Tài khoản dịch vụ có thể được liên kết 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 và sẽ bị xoá nếu doanh nghiệp không bị ràng buộc. 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ủ.
số
Phương thức này chỉ có thể được gọi sau khi gọi Enterprises.enroll hoặc Enterprises.CompleteSignup, và trước khi Enterprises.SetAccount; nhưng vào lúc khác, trình duyệt sẽ trả về lỗi.
số
Lệnh gọi tiếp theo sau lệnh gọi đầu tiên sẽ tạo ra một tập hợp mới, duy nhất thông tin xác thực và vô hiệu hoá thông tin đăng nhập đã tạo trước đó.
số
Sau khi liên kết với doanh nghiệp, tài khoản dịch vụ có thể được quản lý 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ố cục cửa hàng chưa được đặt, trả về "cơ bản" làm loại bố cục cửa hàng và không trang chủ.
list: Tì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 trong quy trình sáng tạo. Doanh nghiệp được tạo qua không cần tra cứu mã nhận dạng quy trình do EMM tìm hiểu mã doanh nghiệp trong lệnh gọi lại được chỉ định trong lệnh gọi Enterprises.generateSignupUrl.
pullNotificationSet: Lấy và trả về một nhóm thông báo cho các doanh nghiệp 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ể hãy để trống nếu không có thông báo nào đang chờ xử lý.
Cần xác nhận một nhóm thông báo được trả về trong vòng 20 giây bằng cách gọi Enterprises.ConfirmNotificationSet, trừ khi bộ thông báo trống.
Những thông báo không được xác nhận trong vòng 20 giây sẽ cuối cùng sẽ được đưa vào lại phản hồi cho một PullNotificationSet khác và những yêu cầu không bao giờ được xác nhận cuối cùng sẽ bị xoá theo chính sách hệ thống Google Cloud Platform Pub/Sub.
Nhiều yêu cầu có thể được thực hiện đồng thời để truy xuất trong trường hợp đó thông báo đang chờ xử lý (nếu có) sẽ được được chia cho từng phương thức gọi (nếu có).
Nếu không có thông báo nào thì hệ thống sẽ trả về một danh sách thông báo trống. Các yêu cầu tiếp theo có thể trả về các thông báo khác sau khi nhận được sẵn có.
sendTestPushNotification: Gửi thông báo thử nghiệm để xác thực quá trình tích hợp EMM với dịch vụ Google Cloud Pub/Sub dành cho doanh nghiệp này.
setAccount: Đặt tài khoản sẽ được dùng để xác thực API dưới dạng doanh nghiệp.
setStoreLayout: Thiết lập bố cục cửa hàng cho doanh nghiệp. Theo mặc định, storeLayoutType được đặt thành "cơ bản" và bố cục cửa hàng cơ bản được bật. Cơ bản bố cục chỉ chứa các ứng dụng được quản trị viên phê duyệt và có được thêm vào bộ sản phẩm có sẵn cho người dùng (bằng cách sử dụ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 của họ. Nếu bạn tạo bố cục cửa hàng tuỳ chỉnh (bằng cách đặt storeLayoutType = "tuỳ chỉnh" và đặt một trang chủ), cửa hàng cơ bản bố cục bị vô hiệu hoá.
huỷ đăng ký: Huỷ đăng ký dịch vụ EMM (quản lý thiết bị di động doanh nghiệp) gọi điện.