REST Resource: enterprises.enrollmentTokens

Recurso: EnrollmentToken

Un token de inscripción

Representación 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

Es el nombre del token de inscripción, que genera el servidor durante la creación, en el formato enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Es el valor del token que se pasa al dispositivo y lo autoriza a inscribirse. Este es un campo de solo lectura que genera el servidor.
duration

string (Duration format)

Es la cantidad de tiempo durante la cual es válido el token de inscripción, que puede variar de 1 minuto a Durations.MAX_VALUE, aproximadamente 10,000 años. Si no se especifica, la duración predeterminada es de 1 hora. Ten en cuenta que, si la duración solicitada hace que el expirationTimestamp resultante supere Timestamps.MAX_VALUE, expirationTimestamp se convierte en Timestamps.MAX_VALUE.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
expirationTimestamp

string (Timestamp format)

Es la hora de vencimiento del token. Este es un campo de solo lectura que genera el servidor.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
policyName

string

Es el nombre de la política que se aplicó inicialmente al dispositivo inscrito, en el formato enterprises/{enterpriseId}/policies/{policyId}. Si no se especifica, se aplica el policyName para el usuario del dispositivo. Si tampoco se especifica userName, se aplica enterprises/{enterpriseId}/policies/default de forma predeterminada. Cuando actualices este campo, puedes especificar solo el policyId, siempre que no contenga barras diagonales.policyId Se inferirá el resto del nombre de la política.
additionalData

string

Datos arbitrarios opcionales asociados con el token de inscripción. Por ejemplo, podría contener el ID de una unidad organizativa a la que se asigna el dispositivo después de la inscripción. Después de que un dispositivo se inscriba con el token, estos datos se expondrán en el campo enrollmentTokenData del recurso Device. Los datos deben tener 1,024 caracteres o menos. De lo contrario, la solicitud de creación fallará.
qrCode

string

Es una cadena JSON cuya representación UTF-8 se puede usar para generar un código QR que inscriba un dispositivo con este token de inscripción. Para inscribir un dispositivo con NFC, el registro de NFC debe contener una representación java.util.Properties serializada de las propiedades en el archivo JSON.
oneTimeOnly

boolean

Indica si el token de inscripción es de un solo uso. Si la marca se establece como verdadera, solo un dispositivo puede usarla para el registro.
user
(deprecated)

object (User)

Este campo dejó de estar disponible y se ignora el valor.
allowPersonalUsage

enum (AllowPersonalUsage)

Controla si se permite el uso personal en un dispositivo aprovisionado con este token de inscripción.

Para dispositivos de la empresa:

  • Si habilitas el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Para inhabilitar el uso personal, el usuario debe aprovisionar el dispositivo como un dispositivo completamente administrado.

Para dispositivos de propiedad personal:

  • Si habilitas el uso personal, el usuario podrá configurar un perfil de trabajo en el dispositivo.
  • Si inhabilitas el uso personal, el dispositivo no se aprovisionará. No se puede inhabilitar el uso personal en dispositivos de propiedad personal.

Métodos

create

 Crea un token de inscripción para una empresa determinada.

delete

 Borra un token de inscripción.

get

 Obtiene un token de inscripción activo y sin vencer.

list

 Muestra una lista de los tokens de inscripción activos y sin vencer de una empresa determinada.