REST Resource: customers.configurations

資源：設定

設定會收集 Android 裝置的佈建選項。每項設定都包含下列項目：

  • 裝置上安裝的 EMM 裝置政策控制器 (DPC)。
  • 已對裝置強制執行 EMM 政策。
  • 裝置上顯示的中繼資料，用於協助使用者進行設定。

客戶可以視需求新增不限數量的設定。不過，只要客戶調整預設設定，該設定會套用至機構購買的新裝置，就能充分發揮零接觸註冊機制的效用。

JSON 表示法 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
欄位
name

string

僅供輸出。API 資源名稱，格式為 customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]。由伺服器指派。
configurationId

string (int64 format)

僅供輸出。設定的 ID。由伺服器指派。
configurationName

string

必要欄位。說明設定用途的簡稱，例如「銷售團隊」或「臨時員工」。IT 管理員會在零接觸註冊機制入口網站看到這個名稱。
dpcResourcePath

string

必要欄位。所選裝置政策控制器 (DPC) 的資源名稱，格式為 customers/[CUSTOMER_ID]/dpcs/*。如要列出支援的 DPC，請呼叫 customers.dpcs.list。
dpcExtras

string

傳遞至 DPC 的 JSON 格式的 EMM 佈建額外項目。
companyName

string

必要欄位。機構名稱。在裝置佈建期間，零接觸註冊機制會向裝置使用者顯示這個機構名稱。
contactEmail

string

必要欄位。裝置使用者可聯絡以取得協助的電子郵件地址。在裝置佈建作業開始前，零接觸註冊機制會向裝置使用者顯示這個電子郵件地址。輸入內容會經過驗證。
contactPhone

string

必要欄位。可供裝置使用者透過其他裝置通話以取得協助的電話號碼。在裝置佈建作業開始前，零接觸註冊機制會向裝置使用者顯示這組號碼。接受數字、空格、加號、連字號和括號。
customMessage

string

包含一或兩句訊息的訊息，用於協助裝置使用者取得說明或進一步說明裝置情況。在裝置佈建作業開始前，零接觸註冊機制會顯示您的自訂訊息。
isDefault

boolean

必要欄位。這個設定是否為零接觸註冊機制的預設設定，會套用至機構日後購買的所有新裝置。只能將一項客戶設定設為預設。將此值設為 true，會將先前預設設定的 isDefault 值變更為 false。
forcedResetTime

string (Duration format)

選用設定。如果裝置無法透過設定精靈完成佈建程序，導致裝置強制恢復原廠設定前的逾時期限，通常是因為設定精靈期間沒有網路連線。範圍介於 0 到 6 小時之間；如果不設定，則為 2 小時。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

方法

create

 建立新的設定。

delete

 刪除未使用的設定。

get

 取得設定的詳細資料。

list

 列出客戶的設定。

patch

 更新設定的欄位值。