資源:Enterprise
設定適用於企業。
JSON 表示法 |
---|
{ "name": string, "enabledNotificationTypes": [ enum ( |
欄位 | |
---|---|
name |
伺服器在建立時產生的企業名稱,格式為 |
enabledNotificationTypes[] |
為企業啟用的 Google Pub/Sub 通知類型。 |
pubsubTopic |
Pub/Sub 通知的發布目標主題,格式為 |
primaryColor |
一種 RGB 格式的顏色,代表裝置管理應用程式 UI 中顯示的主要色彩。顏色元件的儲存方式如下: |
logo |
在裝置佈建過程中顯示為標誌的圖片。支援的類型如下:image/bmp、image/gif、image/x-ico、image/jpeg、image/png、image/webp、image/vnd.wap.wbmp、image/x-adobe-dng。 |
enterpriseDisplayName |
向使用者顯示的企業名稱。這個欄位的長度上限為 100 個字元。 |
termsAndConditions[] |
為這個企業佈建裝置時必須接受的條款及細則。系統會為這份清單中的每個值產生一頁字詞。 |
appAutoApprovalEnabled |
已淘汰且未使用。 |
signinDetails[] |
企業的登入詳細資料。 |
contactInfo |
EMM 管理的企業聯絡資訊。 |
NotificationType
裝置管理伺服器可透過 Google Pub/Sub 傳送的通知類型。
列舉 | |
---|---|
NOTIFICATION_TYPE_UNSPECIFIED |
系統會忽略這個值。 |
ENROLLMENT |
在裝置註冊時傳送通知。 |
COMPLIANCE_REPORT |
已淘汰。 |
STATUS_REPORT |
系統會在裝置發出狀態報告時傳送通知。 |
COMMAND |
裝置指令完成後,系統會傳送通知。 |
USAGE_LOGS |
裝置傳送 時,已傳送通知。 |
ExternalData
託管在外部位置的資料。資料會由 Android Device Policy 下載,並根據雜湊進行驗證。
JSON 表示法 |
---|
{ "url": string, "sha256Hash": string } |
欄位 | |
---|---|
url |
資料的絕對網址 (必須使用 http 或 https 通訊協定)。Android Device Policy 不會在 GET 要求中提供任何憑證,因此網址必須可公開存取。在網址中加入隨機的長元件,可能會被用來阻止攻擊者找到 URL。 |
sha256Hash |
網址代管內容的 Base-64 編碼 SHA-256 雜湊。如果內容與此雜湊不相符,Android Device Policy 就不會使用這些資料。 |
TermsAndConditions
要在佈建時接受的條款及細則頁面。
JSON 表示法 |
---|
{ "header": { object ( |
欄位 | |
---|---|
header |
顯示在 HTML 內容上方的簡短標頭。 |
content |
格式正確的 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 ( |
欄位 | |
---|---|
signinUrl |
透過登入註冊權杖為裝置佈建時用於驗證的登入網址。登入端點應使用網址 (https://enterprise.google.com/android/enroll?et= |
signinEnrollmentToken |
用於觸發自訂登入流程的全企業註冊權杖。這是伺服器產生的唯讀欄位。 |
qrCode |
以 UTF-8 表示的 JSON 字串,可產生 QR code,透過這個註冊權杖註冊裝置。如要使用 NFC 註冊裝置,NFC 記錄必須包含 JSON 中屬性的序列化 |
allowPersonalUsage |
控管是否允許在透過這個註冊權杖佈建的裝置上使用個人用途。 公司擁有的裝置:
如果是個人裝置:
|
tokenTag |
EMM 指定的中繼資料,用於區分 |
ContactInfo
Google Play 管理版企業的詳細聯絡資料。
JSON 表示法 |
---|
{ "contactEmail": string, "dataProtectionOfficerName": string, "dataProtectionOfficerEmail": string, "dataProtectionOfficerPhone": string, "euRepresentativeName": string, "euRepresentativeEmail": string, "euRepresentativePhone": string } |
欄位 | |
---|---|
contactEmail |
聯絡窗口的電子郵件地址,用於傳送與 Google Play 管理版相關的重要公告。 |
dataProtectionOfficerName |
資料保護長的姓名。 |
dataProtectionOfficerEmail |
資料保護長的電子郵件。電子郵件已通過驗證,但尚未驗證。 |
dataProtectionOfficerPhone |
資料保護長的電話號碼。電話號碼已通過驗證,但尚未驗證。 |
euRepresentativeName |
歐盟代表的姓名。 |
euRepresentativeEmail |
歐盟代表的電子郵件地址。電子郵件已通過驗證,但尚未驗證。 |
euRepresentativePhone |
歐盟代表的電話號碼。電話號碼已完成驗證,但尚未驗證。 |
方法 |
|
---|---|
|
建立企業。 |
|
永久刪除企業以及所有相關聯的帳戶和資料。 |
|
取得企業。 |
|
列出由 EMM 管理的企業。 |
|
更新企業。 |