REST Resource: enterprises

資源：Enterprise

設定適用於企業。

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)
  }
}
欄位
name

string

伺服器在建立時產生的企業名稱，格式為 enterprises/{enterpriseId}。
enabledNotificationTypes[]

enum (NotificationType)

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

string

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

integer

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

string

向使用者顯示的企業名稱。這個欄位的長度上限為 100 個字元。
termsAndConditions[]

object (TermsAndConditions)

為這個企業佈建裝置時必須接受的條款及細則。系統會為這份清單中的每個值產生一頁字詞。
appAutoApprovalEnabled
(deprecated)

boolean

已淘汰且未使用。
signinDetails[]

object (SigninDetail)

企業的登入詳細資料。
contactInfo

object (ContactInfo)

EMM 管理的企業聯絡資訊。

NotificationType

裝置管理伺服器可透過 Google Pub/Sub 傳送的通知類型。

列舉
NOTIFICATION_TYPE_UNSPECIFIED 系統會忽略這個值。
ENROLLMENT 在裝置註冊時傳送通知。
COMPLIANCE_REPORT

已淘汰。
STATUS_REPORT 系統會在裝置發出狀態報告時傳送通知。
COMMAND 裝置指令完成後，系統會傳送通知。
USAGE_LOGS 裝置傳送 BatchUsageLogEvents 時，已傳送通知。

ExternalData

託管在外部位置的資料。資料會由 Android Device Policy 下載，並根據雜湊進行驗證。

JSON 表示法 
{
  "url": string,
  "sha256Hash": string
}
欄位
url

string

資料的絕對網址 (必須使用 http 或 https 通訊協定)。Android Device Policy 不會在 GET 要求中提供任何憑證，因此網址必須可公開存取。在網址中加入隨機的長元件，可能會被用來阻止攻擊者找到 URL。
sha256Hash

string

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

TermsAndConditions

要在佈建時接受的條款及細則頁面。

JSON 表示法 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
欄位
header

object (UserFacingMessage)

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

object (UserFacingMessage)

格式正確的 HTML 字串。系統會在用戶端透過 android.text.Html#fromHtml 剖析此屬性。

SigninDetail

這是包含企業登入詳細資料的資源。使用 enterprises 管理特定企業的 SigninDetail。

以企業來說，我們可以用下列三個欄位 (signinUrl、allowPersonalUsage、tokenTag) 的組合來識別不重複的 SigninDetail。使用者不能建立兩個具有相同 (signinUrl、allowPersonalUsage、tokenTag) 的 SigninDetail (tokenTag 是選填欄位)。

Patch：作業會以新的 SigninDetails 清單更新目前的 SigninDetails 清單。

  • 如果傳遞已儲存的 SigninDetail 設定，則會傳回相同的 signinEnrollmentToken 和 qrCode。
  • 如果我們傳遞多個未儲存的相同 SigninDetail 設定，則會從這些 SigninDetail 設定中儲存第一個設定。
  • 如果設定已存在，則無法在特定修補 API 呼叫中重複要求設定，否則會產生重複的金鑰錯誤，並導致整個作業失敗。
  • 如果我們從要求中移除某些 SigninDetail 設定，該設定也會從儲存空間中移除。這樣一來，我們就可以針對相同的 SigninDetail 設定要求額外的 signinEnrollmentToken 和 qrCode。
JSON 表示法 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
欄位
signinUrl

string

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

string

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

string

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

enum (AllowPersonalUsage)

控管是否允許在透過這個註冊權杖佈建的裝置上使用個人用途。

公司擁有的裝置：

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

如果是個人裝置：

  • 啟用個人使用功能後，使用者即可在裝置上設定工作資料夾。
  • 停用個人使用設定會導致裝置無法佈建。無法在個人擁有的裝置上停用個人使用功能。
tokenTag

string

EMM 指定的中繼資料，用於區分 SigninDetail 的執行個體。

ContactInfo

Google Play 管理版企業的詳細聯絡資料。

JSON 表示法 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
欄位
contactEmail

string

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

string

資料保護長的姓名。
dataProtectionOfficerEmail

string

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

string

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

string

歐盟代表的姓名。
euRepresentativeEmail

string

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

string

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

方法

create

 建立企業。

delete

 永久刪除企業以及所有相關聯的帳戶和資料。

get

 取得企業。

list

 列出由 EMM 管理的企業。

patch

 更新企業。