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 ao 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, que varia de 1 minuto a Durations.MAX_VALUE, aproximadamente 10.000 anos. Se não for especificado, a duração padrão será de 1 hora. Se a duração solicitada fizer com que o expirationTimestamp resultante exceda Timestamps.MAX_VALUE, o expirationTimestamp será forçado para Timestamps.MAX_VALUE.

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.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa 0, 3, 6 ou 9 dígitos fracionários. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
policyName

string

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

string

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

string

Uma string JSON cuja representação UTF-8 pode ser usada para gerar um código QR para registrar um dispositivo com esse token de registro. Para registrar um dispositivo usando NFC, o registro de 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 a flag for definida como verdadeira, apenas um dispositivo poderá usá-la para o registro.
user
(deprecated)

object (User)

Esse 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:

  • Ativar o 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:

  • Ativar o uso pessoal permite que o usuário configure um perfil de trabalho no dispositivo.
  • A desativação do uso pessoal impede o provisionamento do dispositivo. O uso pessoal não pode ser desativado em dispositivos de propriedade 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 os tokens de registro ativos e não expirados de uma determinada empresa.