REST Resource: enterprises.enrollmentTokens

Recurso: EnrollmentToken

Um token de registro.

Representação JSON 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Campos
name

string

O nome do token de registro, que é gerado pelo servidor durante a criação, no formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

O valor do token que é transmitido para o dispositivo e autoriza o registro dele. Este é um campo somente leitura gerado pelo servidor.
duration

string (Duration format)

O período de validade do token de registro, de 1 minuto a Durations.MAX_VALUE, é de aproximadamente 10.000 anos. Se não for especificada, a duração padrão será de uma hora. Se a duração solicitada fizer com que o expirationTimestamp resultante exceda Timestamps.MAX_VALUE, expirationTimestamp será forçado para Timestamps.MAX_VALUE.

Uma duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".
expirationTimestamp

string (Timestamp format)

O prazo de validade do token. Este é um campo somente leitura gerado pelo servidor.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
policyName

string

O nome da política aplicado inicialmente ao dispositivo registrado, no formato enterprises/{enterpriseId}/policies/{policyId}. Se não for especificada, a policyName para o usuário do dispositivo será aplicada. Se userName também não for especificado, enterprises/{enterpriseId}/policies/default será aplicado por padrão. Ao atualizar esse campo, é possível especificar apenas o policyId, desde que o policyId não tenha barras. O restante do nome da política será inferido.
additionalData

string

Dados arbitrários opcionais associados ao token de registro. Ele pode conter, por exemplo, o ID de uma unidade organizacional a que o dispositivo é atribuído após o registro. Depois que um dispositivo for registrado com o token, esses dados serão expostos no campo enrollmentTokenData do recurso Device. Os dados precisam ter até 1.024 caracteres. Caso contrário, a solicitação de criação vai falhar.
qrCode

string

É uma string JSON com representação UTF-8 que pode ser usada para gerar um QR code e registrar um dispositivo com esse token. Para registrar um dispositivo usando NFC, o registro NFC precisa conter uma representação java.util.Properties serializada das propriedades no JSON.
oneTimeOnly

boolean

Indica se o token de registro é para uso único. Se o flag for definido como verdadeiro, apenas um dispositivo poderá usá-lo para registro.
user
(deprecated)

object (User)

O uso deste campo foi descontinuado, e o valor é ignorado.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla se o uso pessoal é permitido em um dispositivo provisionado com esse token de registro.

Para dispositivos da empresa:

  • A ativação do uso pessoal permite que o usuário configure um perfil de trabalho no dispositivo.
  • Para desativar o uso pessoal, o usuário precisa provisionar o dispositivo como totalmente gerenciado.

Para dispositivos pessoais:

  • A ativação do uso pessoal permite que o usuário configure um perfil de trabalho no dispositivo.
  • A desativação do uso pessoal impedirá o provisionamento do dispositivo. O uso pessoal não pode ser desativado em um dispositivo pessoal.

Métodos

create

 Cria um token de registro para uma determinada empresa.

delete

 Exclui um token de registro.

get

 Recebe um token de registro ativo e não expirado.

list

 Lista tokens de registro ativos e não expirados de uma determinada empresa.