REST Resource: enterprises.enrollmentTokens

Recurso: EnrollmentToken

Um token de inscrição.

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 inscrição, 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 inscrição, que varia de 1 minuto a Durations.MAX_VALUE, 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, o expirationTimestamp será forçado para Timestamps.MAX_VALUE.

Duração em segundos com até nove dígitos fracionários, terminando com "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 aplicada inicialmente ao dispositivo registrado, no formato enterprises/{enterpriseId}/policies/{policyId}. Se não for especificado, o policyName para o usuário do dispositivo vai 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 o policyId, desde que o policyId não contenha barras. O restante do nome da política vai ser inferido.
additionalData

string

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

string

Uma string JSON com uma representação UTF-8 que pode ser usada para gerar um código QR para registrar um dispositivo com este 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 a sinalização for definida como verdadeira, apenas um dispositivo poderá usá-la para registro.
user

object (User)

O usuário associado a esse token de inscrição. Se ele for especificado quando o token de inscrição for criado e o usuário não existir, a conta será criada. Este campo não pode conter informações de identificação pessoal. Somente o campo accountIdentifier precisa ser definido.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla se o uso pessoal é permitido em um dispositivo provisionado com este 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.
  • Desativar o uso pessoal impedirá que o dispositivo seja provisionado. 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 inscrição.

get

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

list

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