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 (約 1 萬年)。如未指定，則預設活動時間長度為 1 小時。請注意，如果要求的時間長度導致產生的 expirationTimestamp 超過 Timestamps.MAX_VALUE，則 expirationTimestamp 會強制轉換為 Timestamps.MAX_VALUE。

時間長度以秒為單位，最多可有 9 個小數位數，並應以「s」結尾，例如："3.5s"。

string (Timestamp format)

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

採用 RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位，最多九個小數位數。例如 "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

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

boolean

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

object (User)

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

enum (AllowPersonalUsage)

控制是否允許使用這組註冊權杖佈建的裝置進行個人用途。

公司擁有的裝置：

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

個人裝置：

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