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

 更新設定的欄位值。