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

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

string

El valor del token que se pasa al dispositivo y que autoriza la inscripción del dispositivo. Este es un campo de solo lectura que genera el servidor.
duration

string (Duration format)

La duración del token de inscripción es válida, desde 1 minuto hasta 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, entonces expirationTimestamp se coerciona a 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)

La fecha y hora de vencimiento del token. Este es un campo de solo lectura que genera el servidor.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
policyName

string

Es el nombre de la política que se aplicó inicialmente al dispositivo inscrito, con 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 actualizas este campo, puedes especificar solo el policyId, siempre que el policyId no contenga barras. Se inferirá el resto del nombre de la política.
additionalData

string

Datos opcionales y arbitrarios asociados con el token de inscripción. Podría contener, por ejemplo, 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 inscribe con el token, estos datos se mostrará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

Una cadena JSON cuya representación UTF-8 se puede usar para generar un código QR para inscribir un dispositivo con este token de inscripción. Para inscribir un dispositivo con NFC, el registro NFC debe contener una representación java.util.Properties serializada de las propiedades en el 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 está obsoleto 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, no se aprovisionará el dispositivo. No se puede inhabilitar el uso personal en un dispositivo 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 no vencido.

list

 Enumera los tokens de inscripción activos y no vencidos de una empresa determinada.