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)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  },
  "enterpriseType": enum (EnterpriseType),
  "managedGooglePlayAccountsEnterpriseType": enum (ManagedGooglePlayAccountsEnterpriseType),
  "managedGoogleDomainType": enum (ManagedGoogleDomainType)
}
Trường
name

string

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

enum (NotificationType)

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

string

Chủ đề mà thông báo Pub/Sub được xuất bản, ở dạng projects/{project}/topics/{topic}. Bạn chỉ cần điền trường này nếu bật thông báo Pub/Sub.
primaryColor

integer

Màu ở định dạng RGB cho biết màu chủ đạo cần 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 (bao gồm cả 0 và 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)

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

boolean

Ngừng hoạt động và không dùng đến.
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ý.
googleAuthenticationSettings

object (GoogleAuthenticationSettings)

Chế độ cài đặt để xác thực người dùng do Google cung cấp.
enterpriseType

enum (EnterpriseType)

Chỉ có đầu ra. Loại hình doanh nghiệp.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Chỉ có đầu ra. Loại tập hợp Tài khoản Google Play có quản lý.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Chỉ có đầu ra. Loại miền được quản lý trên Google.

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 Thông báo được gửi khi một thiết bị đăng ký.
COMPLIANCE_REPORT

Không dùng nữa.
STATUS_REPORT Thông báo được gửi khi thiết bị phát hành báo cáo trạng thái.
COMMAND Thông báo được gửi khi một lệnh cho thiết bị đã hoàn tất.
USAGE_LOGS Thông báo được gửi khi thiết bị gửi BatchUsageLogEvents.
ENTERPRISE_UPGRADE Thông báo được gửi cho một lần nâng cấp lên phiên bản dành cho doanh nghiệp. Nâng cấp doanh nghiệp là quy trình nâng cấp một doanh nghiệp có Tài khoản Google Play được quản lý lên một miền mua qua Google được quản lý.

ExternalData

Dữ liệu được lưu trữ ở một vị trí bên ngoài. Android Device Policy sẽ tải dữ liệu xuống và 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 giao thức http hoặc https. Android Device Policy không cung cấp thông tin đăng nhập 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 ngẫu nhiên, dài vào URL có thể giúp ngăn chặn kẻ tấn công phát hiện ra URL.
sha256Hash

string

Hàm băm SHA-256 được mã hoá theo cơ số 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.

TermsAndConditions

Một trang điều khoản và điều kiện cần được chấp nhận trong quá trình cung cấp.

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

object (UserFacingMessage)

Một 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 đúng cách. Nội dung này sẽ được phân tích cú pháp trên ứng dụng bằng android.text.Html#fromHtml.

SigninDetail

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

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

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

  • Nếu bạn truyền cấu hình SigninDetail đã lưu trữ, thì hàm này sẽ trả về cùng signinEnrollmentToken và qrCode.
  • Nếu chúng ta truyền nhiều cấu hình SigninDetail giống nhau không được lưu trữ, thì hệ thống sẽ lưu trữ cấu hình SigninDetail đầu tiên trong số đó.
  • nếu cấu hình đã tồn tại, chúng ta không thể yêu cầu cấu hình đó nhiều lần trong một lệnh gọi API vá cụ thể, nếu không, lệnh gọi sẽ đưa 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 ta xoá một số cấu hình 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),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
Trường
signinUrl

string

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

string

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

string

Một chuỗi JSON mà bạn có thể dùng biểu thị UTF-8 để tạo mã QR nhằm đăng ký một thiết bị bằng mã thông báo đăng ký này. Để đăng ký thiết bị bằng NFC, bản ghi NFC phải chứa một biểu thị java.util.Properties được chuyển đổi tuần tự của các thuộc tính trong JSON. Đây là một 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 thiết bị được cấp phép bằng mã thông báo đăng ký này cho mục đích cá nhân hay không.

Đối với thiết bị do công ty sở hữu:

  • Khi cho phép sử dụng cho mục đích 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 cung cấp 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á nhân:

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

enum (SigninDetailDefaultStatus)

Không bắt buộc. Có nên sử dụng URL đăng nhập theo mặc định cho doanh nghiệp hay không. SigninDetail có defaultStatus được đặt thành SIGNIN_DETAIL_IS_DEFAULT được dùng cho phương thức đăng ký Tài khoản Google. Chỉ một trong số các signinDetails của doanh nghiệp mới có thể đặt defaultStatus thành SIGNIN_DETAIL_IS_DEFAULT. Nếu một Enterprise có ít nhất một signinDetails và không có signinDetails nào có defaultStatus được đặt thành SIGNIN_DETAIL_IS_DEFAULT thì signinDetails đầu tiên trong danh sách sẽ được chọn và có defaultStatus được đặt thành SIGNIN_DETAIL_IS_DEFAULT. Nếu không có signinDetails nào được chỉ định cho Enterprise thì quá trình đăng ký thiết bị bằng Tài khoản Google sẽ không thành công.
tokenTag

string

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

SigninDetailDefaultStatus

Có nên sử dụng URL đăng nhập theo mặc định cho doanh nghiệp hay không.

Enum
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED Tương đương với SIGNIN_DETAIL_IS_NOT_DEFAULT.
SIGNIN_DETAIL_IS_DEFAULT Theo mặc định, URL đăng nhập sẽ được dùng cho doanh nghiệp.
SIGNIN_DETAIL_IS_NOT_DEFAULT Theo mặc định, doanh nghiệp sẽ không sử dụng URL đăng nhập.

ContactInfo

Thông tin liên hệ cho các doanh nghiệp sử dụng Google Play được quản lý.

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 ngườ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 Google Play được quản lý.
dataProtectionOfficerName

string

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

string

Email của chuyê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.

GoogleAuthenticationSettings

Chứa các chế độ cài đặt để xác thực người dùng do Google cung cấp.

Biểu diễn dưới dạng JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Trường
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Chỉ có đầu ra. Người dùng có cần được Google xác thực trong quá trình đăng ký hay không. Quản trị viên CNTT có thể chỉ định xem doanh nghiệp có bật tính năng xác thực bằng Google cho các thiết bị của nhân viên tri thức hay không. Bạn chỉ có thể đặt giá trị này thông qua Bảng điều khiển dành cho quản trị viên của Google. Bạn có thể sử dụng quy trình xác thực của Google với signinUrl Trong trường hợp quy trình xác thực của Google là bắt buộc và bạn chỉ định một signinUrl, quy trình xác thực của Google sẽ được khởi chạy trước signinUrl.

GoogleAuthenticationRequired

Chế độ cài đặt cho việc có bắt buộc phải xác thực bằng Google đối với doanh nghiệp này hay không.

Enum
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED Giá trị này không được sử dụng.
NOT_REQUIRED Bạn không bắt buộc phải xác thực bằng Google.
REQUIRED Người dùng phải được Google xác thực thành công.

EnterpriseType

Loại hình doanh nghiệp.

Enum
ENTERPRISE_TYPE_UNSPECIFIED Giá trị này không được sử dụng.
MANAGED_GOOGLE_DOMAIN Doanh nghiệp thuộc một miền mua qua Google được quản lý.
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE Doanh nghiệp này là một tập hợp Tài khoản Google Play có quản lý.

ManagedGooglePlayAccountsEnterpriseType

Loại tập hợp Tài khoản Google Play có quản lý.

Enum
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE_TYPE_UNSPECIFIED Bạn chưa chỉ định loại tập hợp Tài khoản Google Play có quản lý.
CUSTOMER_MANAGED Doanh nghiệp do khách hàng quản lý
EMM_MANAGED Doanh nghiệp này do EMM quản lý (không được dùng nữa).

ManagedGoogleDomainType

Loại miền được quản lý trên Google.

Enum
MANAGED_GOOGLE_DOMAIN_TYPE_UNSPECIFIED Bạn chưa chỉ định loại miền Google được quản lý.
TYPE_TEAM Miền Google được quản lý là một nhóm được xác minh bằng email.
TYPE_DOMAIN Miền Google được quản lý đã được xác minh bằng miền.

Phương thức

create

 Tạo một doanh nghiệp.

delete

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

generateEnterpriseUpgradeUrl

 Tạo một URL nâng cấp doanh nghiệp để nâng cấp một tập hợp Tài khoản Google Play có quản lý hiện có lên một miền mua qua Google được quản lý.

get

 Nhận 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.