REST Resource: enterprises

{
  "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)
  }
}

string

伺服器在建立期間產生的企業名稱，格式為 enterprises/{enterpriseId}。

enum (NotificationType)

為企業啟用的 Google Pub/Sub 通知類型。

string

Pub/Sub 通知的發布目標主題，格式為 projects/{project}/topics/{topic}。只有在 Pub/Sub 通知已啟用的情況下，才需要這個欄位。

integer

採用 RGB 格式的顏色，代表裝置管理應用程式 UI 中顯示的主要顏色。顏色元件的儲存方式如下：(red << 16) | (green << 8) | blue，其中每個元件的值介於 0 到 255 (含) 之間。

object (ExternalData)

在裝置佈建期間顯示為標誌的圖片。支援的類型包括：image/bmp、image/gif、image/x-ico、image/jpeg、image/png、image/webp、image/vnd.wap.wbmp、image/x-adobe-dng。

string

向使用者顯示的公司名稱。這個欄位的長度上限為 100 個字元。

object (TermsAndConditions)

為這個企業佈建裝置時必須接受的條款及細則。系統會針對此清單中的每個值產生字詞頁面。

boolean

已淘汰且未使用。

object (SigninDetail)

企業的登入詳細資料。

object (ContactInfo)

由 EMM 管理的企業提供的企業聯絡資訊。

object (GoogleAuthenticationSettings)

Google 提供的使用者驗證設定。

{
  "url": string,
  "sha256Hash": string
}

string

資料的絕對網址，必須使用 http 或 https 配置。由於 Android Device Policy 不會在 GET 要求中提供任何憑證，因此網址必須可公開存取。您可以在網址中加入一個漫長的隨機元件，防止攻擊者發現網址。

string

網址代管內容的 Base-64 編碼 SHA-256 雜湊。如果內容與這個雜湊不相符，Android Device Policy 就不會使用這些資料。

{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}

object (UserFacingMessage)

在 HTML 內容上方顯示的簡短標頭。

object (UserFacingMessage)

格式良好的 HTML 字串。系統將會在用戶端上使用 android.text.Html#fromHtml 進行剖析。

{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}

string

裝置透過登入註冊權杖佈建裝置時，用於驗證的登入網址。登入端點應以 https://enterprise.google.com/android/enroll?et= 的格式完成登入驗證流程，或成功登入：https://enterprise.google.com/android/enroll/invalid。

string

適用於觸發自訂登入流程的全企業註冊權杖。這是伺服器產生的唯讀欄位。

string

使用 UTF-8 表示法的 JSON 字串來產生 QR code，藉此透過這個註冊權杖註冊裝置。如要使用 NFC 註冊裝置，NFC 記錄必須包含 JSON 中的屬性序列化 java.util.Properties 表示法。這是伺服器產生的唯讀欄位。

enum (AllowPersonalUsage)

控管是否允許在以此註冊權杖佈建的裝置上用於個人用途。

公司擁有的裝置：

• 啟用個人用途後，使用者就能在裝置上設定工作資料夾。
• 如要停用個人用途，使用者必須將裝置佈建為全代管裝置，

如果是個人裝置：

• 啟用個人用途後，使用者就能在裝置上設定工作資料夾。
• 停用個人用途後，就無法佈建裝置。您無法停用個人裝置上的個人使用功能。

enum (SigninDetailDefaultStatus)

選用設定。是否預設為企業使用登入網址。defaultStatus 設為 SIGNIN_DETAIL_IS_DEFAULT 的 SigninDetail 會用於 Google 帳戶註冊方法。只有一個企業的 signinDetails 可將 defaultStatus 設定為 SIGNIN_DETAIL_IS_DEFAULT。如果 Enterprise 至少有一個 signinDetails，且所有 defaultStatus 都未設定為 SIGNIN_DETAIL_IS_DEFAULT，系統就會選取清單的第一個項目，並將 defaultStatus 設為 SIGNIN_DETAIL_IS_DEFAULT。如果沒有為 Enterprise 指定 signinDetails，Google 帳戶裝置註冊就會失敗。

string

用來區分 SigninDetail 執行個體的 EMM 中繼資料。

{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}

string

聯絡窗口的電子郵件地址，用於傳送與 Google Play 管理版相關的重要公告。

string

資料保護長的姓名。

string

資料保護長的電子郵件地址。電子郵件已通過驗證，但尚未驗證。

string

資料保護長的電話號碼。電話號碼已通過驗證，但尚未驗證。

string

歐盟代表的姓名。

string

歐盟代表的電子郵件地址。電子郵件已通過驗證，但尚未驗證。

string

歐盟代表的電話號碼。電話號碼已通過驗證，但尚未驗證。

{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}

enum (GoogleAuthenticationRequired)

僅供輸出。使用者是否需要在註冊程序中通過 Google 驗證。IT 管理員可以指定是否要為企業啟用知識工作者裝置的 Google 驗證功能。這個值只能透過 Google 管理控制台設定。Google 驗證可以搭配 signinUrl 使用。在需要 Google 驗證且指定 signinUrl 的情況下，Google 驗證將在 signinUrl 之前啟動。