- 資源:Enterprise
- NotificationType
- ExternalData
- TermsAndConditions
- SigninDetail
- SigninDetailDefaultStatus
- ContactInfo
- GoogleAuthenticationSettings
- GoogleAuthenticationRequired
- 方法
資源:Enterprise
套用至企業的設定。
JSON 表示法 |
---|
{ "name": string, "enabledNotificationTypes": [ enum ( |
欄位 | |
---|---|
name |
企業名稱,由伺服器在建立期間產生,格式為 |
enabled |
企業啟用的 Google Pub/Sub 通知類型。 |
pubsub |
發布 Pub/Sub 通知的主題,格式為 |
primary |
RGB 格式的顏色,用於表示在裝置管理應用程式 UI 中顯示的主要顏色。顏色元件的儲存方式如下: |
logo |
在裝置佈建期間顯示為標誌的圖片。支援的類型包括:image/bmp、image/gif、image/x-ico、image/jpeg、image/png、image/webp、image/vnd.wap.wbmp、image/x-adobe-dng。 |
enterprise |
向使用者顯示的公司名稱。這個欄位的長度上限為 100 個字元。 |
terms |
為這個企業佈建裝置時必須接受的條款及細則。系統會針對清單中的每個值產生一個條款頁面。 |
appAutoApprovalEnabled |
已淘汰且未使用。 |
signin |
企業的登入詳細資料。 |
contact |
由 EMM 管理的企業提供的企業聯絡資訊。 |
google |
Google 提供的使用者驗證設定。 |
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 要求中提供任何憑證,因此網址必須可供公眾存取。您可以在網址中加入一個漫長的隨機元件,防止攻擊者發現網址。 |
sha256 |
網址代管內容的 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
。一個不能建立兩個具有相同相同欄位的 SigninDetail
(signinUrl
、allowPersonalUsage
、tokenTag
)。(tokenTag
為選用欄位)。
:此作業會以新的 Patch
SigninDetails
清單更新目前的 SigninDetails
清單。
- 如果傳遞儲存的
SigninDetail
設定,則會傳回相同的signinEnrollmentToken
和qrCode
。 - 如果我們傳遞多個相同的
SigninDetail
設定,且未儲存,系統會儲存這些SigninDetail
設定中的第一個設定。 - 如果設定已存在,我們就無法在特定修補程序 API 呼叫中要求多次,否則會傳回重複索引鍵錯誤,整個作業也會失敗。
- 如果我們從要求中移除特定
SigninDetail
設定,該設定就會從儲存空間中移除。接著,我們可以針對相同的SigninDetail
設定要求另一個signinEnrollmentToken
和qrCode
。
JSON 表示法 |
---|
{ "signinUrl": string, "signinEnrollmentToken": string, "qrCode": string, "allowPersonalUsage": enum ( |
欄位 | |
---|---|
signin |
當裝置使用登入註冊權杖進行佈建時,用於驗證的登入網址。登入端點應使用 https://enterprise.google.com/android/enroll?et= |
signin |
適用於觸發自訂登入流程的全企業註冊權杖。這是由伺服器產生的唯讀欄位。 |
qr |
使用 UTF-8 表示法的 JSON 字串來產生 QR code,藉此透過這個註冊權杖註冊裝置。如要使用 NFC 註冊裝置,NFC 記錄必須包含 JSON 中屬性的序列化 |
allow |
控制是否允許使用這組註冊權杖佈建的裝置進行個人用途。 公司擁有的裝置:
個人裝置:
|
default |
選用設定。是否預設為企業使用登入網址。 |
token |
EMM 指定的中繼資料,用於區分 |
SigninDetailDefaultStatus
企業是否應預設使用登入網址。
列舉 | |
---|---|
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED |
等同於 SIGNIN_DETAIL_IS_NOT_DEFAULT 。 |
SIGNIN_DETAIL_IS_DEFAULT |
企業預設會使用登入網址。 |
SIGNIN_DETAIL_IS_NOT_DEFAULT |
企業預設不會使用登入網址。 |
ContactInfo
Google Play 管理版企業的詳細聯絡資料。
JSON 表示法 |
---|
{ "contactEmail": string, "dataProtectionOfficerName": string, "dataProtectionOfficerEmail": string, "dataProtectionOfficerPhone": string, "euRepresentativeName": string, "euRepresentativeEmail": string, "euRepresentativePhone": string } |
欄位 | |
---|---|
contact |
聯絡窗口的電子郵件地址,我們會用來傳送與受管理的 Google Play 相關的重要公告。 |
data |
資料保護長的姓名。 |
data |
資料保護長的電子郵件地址。電子郵件已驗證,但尚未完成驗證。 |
data |
資料保護官的電話號碼:電話號碼已驗證,但未經過驗證。 |
eu |
歐盟代表的姓名。 |
eu |
歐盟代表的電子郵件地址。電子郵件已驗證,但尚未完成驗證。 |
eu |
歐盟代表的電話號碼。電話號碼已驗證,但尚未驗證。 |
GoogleAuthenticationSettings
包含 Google 提供的使用者驗證設定。
JSON 表示法 |
---|
{
"googleAuthenticationRequired": enum ( |
欄位 | |
---|---|
google |
僅供輸出。使用者是否需要在註冊程序中通過 Google 驗證。IT 管理員可以指定是否為知識工作者裝置啟用 Google 驗證功能。您只能透過 Google 管理控制台設定這個值。Google 驗證可與 |
GoogleAuthenticationRequired
設定是否需要為這家企業進行 Google 驗證。
列舉 | |
---|---|
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED |
系統不會使用這個值。 |
NOT_REQUIRED |
不需要 Google 驗證。 |
REQUIRED |
使用者必須通過 Google 驗證。 |
方法 |
|
---|---|
|
建立企業。 |
|
永久刪除企業,以及所有相關聯的帳戶和資料。 |
|
取得企業。 |
|
列出由 EMM 管理的企業。 |
|
更新企業。 |