REST Resource: enterprises.enrollmentTokens

{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}

string

伺服器在建立過程中產生的註冊權杖名稱，格式為 enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}。

string

傳遞至裝置的權杖值，並授權裝置進行註冊。這是伺服器產生的唯讀欄位。

string (Duration format)

註冊權杖的有效時間長度，必須介於 1 分鐘至 Durations.MAX_VALUE，約 10,000 年。如未指定，預設時間長度為 1 小時。請注意，如果要求的時間長度會導致產生的 expirationTimestamp 超過 Timestamps.MAX_VALUE，則 expirationTimestamp 會強制為 Timestamps.MAX_VALUE。

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

string (Timestamp format)

權杖的到期時間。這是伺服器產生的唯讀欄位。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

string

註冊裝置最初套用的政策名稱，格式為 enterprises/{enterpriseId}/policies/{policyId}。如未指定，系統會為裝置使用者套用 policyName。如果同時未指定 userName，則預設會套用 enterprises/{enterpriseId}/policies/default。更新這個欄位時，您可以只指定 policyId，只要 policyId 不含任何斜線。系統會推論政策的其餘名稱。

string

與註冊權杖相關的任意資料 (選填)。其中可能包括在註冊裝置後指派給裝置的機構單位 ID。使用權杖註冊裝置後，這項資料會顯示在 Device 資源的 enrollmentTokenData 欄位中。資料不得超過 1024 個半形字元；否則建立要求就會失敗。

string

使用 UTF-8 表示法的 JSON 字串來產生 QR code，藉此透過這個註冊權杖註冊裝置。如要使用 NFC 註冊裝置，NFC 記錄必須包含 JSON 中的屬性序列化 java.util.Properties 表示法。

boolean

註冊權杖是否只能使用一次。如果設為 True，則只有一部裝置可以使用該旗標進行註冊。

object (User)

這個欄位已淘汰，系統會忽略該值。

enum (AllowPersonalUsage)

控管是否允許在以此註冊權杖佈建的裝置上用於個人用途。

公司擁有的裝置：

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

如果是個人裝置：

• 啟用個人用途後，使用者就能在裝置上設定工作資料夾。
• 停用個人用途後，就無法佈建裝置。您無法停用個人裝置上的個人使用功能。