REST Resource: enterprises.enrollmentTokens

リソース: EnrollmentToken

登録トークン。

JSON 表現 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
フィールド
name

string

登録トークンの名前（作成時にサーバーが生成）（enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId} 形式）。
value

string

デバイスに渡され、デバイスの登録を承認するトークン値。サーバーで生成される読み取り専用フィールドです。
duration

string (Duration format)

登録トークンの有効期間。1 分から Durations.MAX_VALUE（約 1 万年）の範囲で指定できます。指定しない場合、デフォルトの時間は 1 時間です。リクエストされた時間により、結果の expirationTimestamp が Timestamps.MAX_VALUE を超える場合、expirationTimestamp は Timestamps.MAX_VALUE に強制変換されます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
expirationTimestamp

string (Timestamp format)

トークンの有効期限。サーバーで生成される読み取り専用フィールドです。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"。
policyName

string

登録済みデバイスに最初に適用されたポリシーの名前（enterprises/{enterpriseId}/policies/{policyId} 形式）。指定しない場合、デバイスのユーザーの policyName が適用されます。userName も指定されていない場合、デフォルトで enterprises/{enterpriseId}/policies/default が適用されます。このフィールドを更新する場合、policyId にスラッシュが含まれていない限り、policyId のみを指定できます。ポリシー名の残りの部分は推測されます。
additionalData

string

登録トークンに関連付けられた任意のデータ（省略可）。たとえば、登録後にデバイスに割り当てられる組織部門の ID を指定できます。デバイスがトークンを使用して登録されると、このデータは Device リソースの enrollmentTokenData フィールドに公開されます。データは 1, 024 文字以下にする必要があります。それ以外の場合、作成リクエストは失敗します。
qrCode

string

UTF-8 表現を使用して QR コードを生成して、この登録トークンを使用してデバイスを登録できる JSON 文字列。NFC を使用してデバイスを登録するには、NFC レコードに JSON 内のプロパティのシリアル化された java.util.Properties 表現を含める必要があります。
oneTimeOnly

boolean

登録トークンが 1 回限りかどうか。このフラグが true に設定されている場合、このフラグを登録に使用できるのは 1 台のデバイスのみです。
user
(deprecated)

object (User)

このフィールドのサポートは終了しており、値は無視されます。
allowPersonalUsage

enum (AllowPersonalUsage)

この登録トークンでプロビジョニングされたデバイスで個人使用を許可するかどうかを管理します。

会社所有デバイスの場合:

  • 個人での使用を有効にすると、ユーザーはデバイスで仕事用プロファイルを設定できます。
  • 個人での使用を無効にするには、ユーザーがデバイスを完全管理対象デバイスとしてプロビジョニングする必要があります。

個人所有のデバイスの場合:

  • 個人での使用を有効にすると、ユーザーはデバイスで仕事用プロファイルを設定できます。
  • 個人での使用を無効にすると、デバイスのプロビジョニングが停止します。個人所有のデバイスでは、個人での使用を無効にできません。

メソッド

create

 特定の企業の登録トークンを作成します。

delete

 登録トークンを削除します。

get

 有効で期限切れでない登録トークンを取得します。

list

 特定のエンタープライズで有効で有効期限が切れていない登録トークンを一覧表示します。