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 ». Пример: "3.5s" .

expirationTimestamp

string ( Timestamp format)

Срок действия токена. Это поле доступно только для чтения и генерируется сервером.

Использует RFC 3339, согласно которому сгенерированный вывод всегда будет нормализован по оси Z и содержать 0, 3, 6 или 9 знаков после запятой. Также допускаются смещения, отличные от «Z». Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

policyName

string

Имя политики, изначально примененной к зарегистрированному устройству, в формате enterprises/{enterpriseId}/policies/{policyId} . Если не указано, применяется имя policyName пользователя устройства. Если userName также не указано, по умолчанию применяется enterprises/{enterpriseId}/policies/default . При обновлении этого поля можно указать только policyId policyId при условии, что он не содержит косых черт. Остальная часть имени политики будет определена автоматически.

additionalData

string

Необязательные произвольные данные, связанные с токеном регистрации. Они могут содержать, например, идентификатор подразделения организации, к которому устройство прикреплено после регистрации. После регистрации устройства с токеном эти данные будут представлены в поле enrollmentTokenData ресурса Device . Длина данных должна быть не более 1024 символов; в противном случае запрос на создание устройства завершится ошибкой.

qrCode

string

Строка JSON, представление которой в кодировке UTF-8 может быть использовано для генерации QR-кода для регистрации устройства с этим токеном регистрации. Для регистрации устройства с помощью NFC запись NFC должна содержать сериализованное представление свойств в java.util.Properties из JSON.

oneTimeOnly

boolean

Является ли токен регистрации одноразовым? Если флаг установлен в значение true, то только одно устройство может использовать его для регистрации.

user
(deprecated)

object ( User )

Это поле устарело, и его значение игнорируется.

allowPersonalUsage

enum ( AllowPersonalUsage )

Контролирует, разрешено ли личное использование устройства, снабженного этим токеном регистрации.

Для корпоративных устройств:

  • Включение личного использования позволяет пользователю настроить рабочий профиль на устройстве.
  • Для отключения личного использования пользователю необходимо настроить устройство как полностью управляемое.

Для личных устройств:

  • Включение личного использования позволяет пользователю настроить рабочий профиль на устройстве.
  • Отключение режима личного использования предотвратит инициализацию устройства. Режим личного использования невозможно отключить на устройстве, принадлежащем пользователю.

Методы

create

 Создает токен регистрации для данного предприятия.

delete

 Удаляет токен регистрации.

get

 Получает активный, неистекший токен регистрации.

list

 Перечисляет активные, неистекшие токены регистрации для заданного предприятия.