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、約 10,000 年）。指定しない場合、デフォルトの期間は 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)

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

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

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

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

  • 個人使用を有効にすると、ユーザーはデバイスに仕事用プロファイルをセットアップできます。
  • 個人での使用を無効にすると、デバイスをプロビジョニングできなくなります。個人所有のデバイスでは、個人使用を無効にできません。

Methods

create

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

delete

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

get

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

list

 指定した企業の有効な登録トークン（期限切れでない）を一覧表示します。