REST Resource: enterprises

Tài nguyên: Doanh nghiệp

Cấu hình được áp dụng cho một doanh nghiệp.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  }
}
Trường
name

string

Tên của doanh nghiệp được máy chủ tạo trong quá trình tạo, có dạng enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

Các loại thông báo trên Google Pub/Sub được bật cho doanh nghiệp.
pubsubTopic

string

Chủ đề sẽ xuất bản thông báo Pub/Sub, có dạng projects/{project}/topics/{topic}. Trường này chỉ bắt buộc nếu thông báo Pub/Sub đang bật.
primaryColor

integer

Một màu ở định dạng RGB cho biết màu chủ đạo để hiển thị trong giao diện người dùng của ứng dụng quản lý thiết bị. Các thành phần màu được lưu trữ như sau: (red << 16) | (green << 8) | blue, trong đó giá trị của mỗi thành phần nằm trong khoảng từ 0 đến 255.
enterpriseDisplayName

string

Tên của doanh nghiệp mà người dùng nhìn thấy. Trường này có độ dài tối đa là 100 ký tự.
termsAndConditions[]

object (TermsAndConditions)

Bạn phải chấp nhận các điều khoản và điều kiện khi cấp phép thiết bị cho doanh nghiệp này. Một trang cụm từ sẽ được tạo cho từng giá trị trong danh sách này.
appAutoApprovalEnabled
(deprecated)

boolean

Không được dùng nữa và không được sử dụng.
signinDetails[]

object (SigninDetail)

Thông tin đăng nhập của doanh nghiệp.
contactInfo

object (ContactInfo)

Thông tin liên hệ của doanh nghiệp do EMM quản lý.

NotificationType

Các loại thông báo mà máy chủ quản lý thiết bị có thể gửi qua Google Pub/Sub.

Enum
NOTIFICATION_TYPE_UNSPECIFIED Giá trị này sẽ bị bỏ qua.
ENROLLMENT Hệ thống sẽ gửi một thông báo khi thiết bị đăng ký.
COMPLIANCE_REPORT

Không dùng nữa.
STATUS_REPORT Đây là một thông báo được gửi khi thiết bị báo cáo trạng thái.
COMMAND Một thông báo được gửi khi lệnh trên thiết bị đã hoàn tất.
USAGE_LOGS Hệ thống sẽ gửi một thông báo khi thiết bị gửi BatchUsageLogEvents.

ExternalData

Dữ liệu được lưu trữ ở một vị trí bên ngoài. Dữ liệu phải được tải xuống bằng Android Device Policy và được xác minh dựa trên hàm băm.

Biểu diễn dưới dạng JSON 
{
  "url": string,
  "sha256Hash": string
}
Trường
url

string

URL tuyệt đối đến dữ liệu (phải sử dụng lược đồ http hoặc https). Android Device Policy không cung cấp bất kỳ thông tin xác thực nào trong yêu cầu GET, vì vậy, URL phải có thể truy cập công khai. Việc thêm một thành phần dài, ngẫu nhiên vào URL có thể dùng để ngăn kẻ tấn công tìm thấy URL đó.
sha256Hash

string

Hàm băm SHA-256 được mã hoá theo base-64 của nội dung được lưu trữ tại url. Nếu nội dung không khớp với hàm băm này, Android Device Policy sẽ không sử dụng dữ liệu này.

TermsAndConditions

Trang điều khoản và điều kiện phải được chấp nhận trong quá trình cấp phép.

Biểu diễn dưới dạng JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Trường
header

object (UserFacingMessage)

Tiêu đề ngắn xuất hiện phía trên nội dung HTML.
content

object (UserFacingMessage)

Một chuỗi HTML được định dạng tốt. Mã này sẽ được phân tích cú pháp trên ứng dụng bằng android.text.html#fromhtml.

SigninDetail

Tài nguyên chứa chi tiết đăng nhập cho một doanh nghiệp. Sử dụng enterprises để quản lý các SigninDetail cho một doanh nghiệp cụ thể.

Đối với doanh nghiệp, chúng ta có thể có số lượng SigninDetail bất kỳ được xác định duy nhất bằng cách kết hợp ba trường sau (signinUrl, allowPersonalUsage, tokenTag). Một trường không thể tạo hai SigninDetail bằng cùng một trường (signinUrl, allowPersonalUsage, tokenTag). (tokenTag là trường không bắt buộc).

Patch: Thao tác cập nhật danh sách SigninDetails hiện tại bằng danh sách SigninDetails mới.

  • Nếu được truyền, cấu hình SigninDetail đã lưu trữ sẽ trả về cùng một signinEnrollmentToken và qrCode.
  • Nếu chúng ta truyền nhiều cấu hình SigninDetail giống hệt nhau nhưng không được lưu trữ, thì cấu hình này sẽ lưu trữ cấu hình đầu tiên trong số các cấu hình SigninDetail đó.
  • nếu cấu hình đã tồn tại, chúng tôi không thể yêu cầu cấu hình đó nhiều lần trong một lệnh gọi API bản vá cụ thể, nếu không sẽ gây ra lỗi khoá trùng lặp và toàn bộ thao tác sẽ không thành công.
  • Nếu chúng tôi xoá một số cấu hình của SigninDetail khỏi yêu cầu, thì cấu hình đó sẽ bị xoá khỏi bộ nhớ. Sau đó, chúng ta có thể yêu cầu một signinEnrollmentToken và qrCode khác cho cùng một cấu hình SigninDetail.
Biểu diễn dưới dạng JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
Trường
signinUrl

string

URL đăng nhập để xác thực khi thiết bị được cấp phép bằng mã thông báo đăng ký đăng nhập. Điểm cuối đăng nhập phải kết thúc quy trình xác thực bằng một URL ở dạng https://enterprise.google.com/android/enroll?et= nếu đăng nhập thành công, hoặc https://enterprise.google.com/android/enroll/invalid đối với lần đăng nhập không thành công.
signinEnrollmentToken

string

Mã thông báo đăng ký cho toàn doanh nghiệp, dùng để kích hoạt quy trình đăng nhập tuỳ chỉnh. Đây là trường chỉ đọc do máy chủ tạo.
qrCode

string

Chuỗi JSON có mã đại diện UTF-8 được dùng để tạo mã QR nhằm đăng ký thiết bị bằng mã thông báo đăng ký này. Để đăng ký một thiết bị bằng NFC, bản ghi NFC phải chứa nội dung trình bày java.util.Properties tuần tự của các thuộc tính trong tệp JSON. Đây là trường chỉ đọc do máy chủ tạo.
allowPersonalUsage

enum (AllowPersonalUsage)

Kiểm soát việc người dùng có được phép sử dụng cho mục đích cá nhân trên thiết bị được cấp phép bằng mã thông báo đăng ký này hay không.

Đối với thiết bị thuộc quyền sở hữu của công ty:

  • Khi bạn bật chế độ sử dụng cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Để tắt chế độ sử dụng cá nhân, người dùng phải cấp phép cho thiết bị dưới dạng thiết bị được quản lý hoàn toàn.

Đối với thiết bị thuộc sở hữu của cá nhân:

  • Khi bạn bật chế độ sử dụng cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Khi bạn tắt chế độ sử dụng cá nhân, thiết bị sẽ không được cấp phép. Không thể tắt chế độ sử dụng cho mục đích cá nhân trên thiết bị thuộc sở hữu của cá nhân.
tokenTag

string

Siêu dữ liệu do EMM chỉ định để phân biệt giữa các bản sao của SigninDetail.

ContactInfo

Thông tin liên hệ dành cho doanh nghiệp trên Managed Google Play.

Biểu diễn dưới dạng JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Trường
contactEmail

string

Địa chỉ email của đầu mối liên hệ. Địa chỉ này sẽ được dùng để gửi các thông báo quan trọng liên quan đến Managed Google Play.
dataProtectionOfficerName

string

Tên của nhân viên bảo vệ dữ liệu.
dataProtectionOfficerEmail

string

Email của nhân viên bảo vệ dữ liệu. Email đã được xác thực nhưng chưa được xác minh.
dataProtectionOfficerPhone

string

Số điện thoại của nhân viên bảo vệ dữ liệu Số điện thoại đã được xác thực nhưng chưa được xác minh.
euRepresentativeName

string

Tên của người đại diện tại Liên minh Châu Âu.
euRepresentativeEmail

string

Email của người đại diện tại Liên minh Châu Âu. Email đã được xác thực nhưng chưa được xác minh.
euRepresentativePhone

string

Số điện thoại của người đại diện tại Liên minh Châu Âu. Số điện thoại đã được xác thực nhưng chưa được xác minh.

Phương thức

create

 Tạo doanh nghiệp.

delete

 Xoá vĩnh viễn một doanh nghiệp cũng như mọi tài khoản và dữ liệu liên kết với doanh nghiệp đó.

get

 Mua một doanh nghiệp.

list

 Liệt kê các doanh nghiệp do EMM quản lý.

patch

 Cập nhật một doanh nghiệp.