Enrollmenttokens: create

Crea un token de inscripción para la empresa. Este método forma parte de EnrollmentTokensService.

Solicitud

Solicitud HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/enrollmentTokens

Parámetros

Nombre del parámetro Valor Descripción
Parámetros de ruta de acceso
enterpriseId string Es el ID de la empresa.

Autorización

Esta solicitud requiere una autorización con el siguiente alcance:

Alcance
https://www.googleapis.com/auth/androidenterprise

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona datos con la siguiente estructura:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nombre de la propiedad Valor Descripción Notas
kind string
token 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.
enrollmentTokenType string [Obligatorio] Es el tipo de token de inscripción.

Los valores aceptables son los siguientes:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Opcional] Es el período durante el que el token de inscripción es válido, que va desde 1 minuto hasta Durations.MAX_VALUE, aproximadamente 10,000 años. Si no se especifica, la duración predeterminada es de 1 hora.
duration.seconds long Son los segundos firmados del período.
googleAuthenticationOptions nested object [Opcional] Proporciona opciones relacionadas con la autenticación de Google durante la inscripción.
googleAuthenticationOptions.authenticationRequirement string [Opcional] Especifica si el usuario debe autenticarse con Google durante la inscripción. Si se proporciona, anula el valor de GoogleAuthenticationSettings para el recurso de la empresa cuando los dispositivos se inscriben con este token.

Los valores aceptables son los siguientes:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Opcional] Especifica la Cuenta de Google administrada que el usuario debe usar durante la inscripción. AuthenticationRequirement se debe establecer en REQUIRED si se configura este campo.

Respuesta

Si se aplica correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nombre de la propiedad Valor Descripción Notas
kind string
token 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.
enrollmentTokenType string [Obligatorio] Es el tipo de token de inscripción.

Los valores aceptables son los siguientes:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Opcional] Es el período durante el que el token de inscripción es válido, que va desde 1 minuto hasta Durations.MAX_VALUE, aproximadamente 10,000 años. Si no se especifica, la duración predeterminada es de 1 hora.
duration.seconds long Son los segundos firmados del período.
googleAuthenticationOptions nested object [Opcional] Proporciona opciones relacionadas con la autenticación de Google durante la inscripción.
googleAuthenticationOptions.authenticationRequirement string [Opcional] Especifica si el usuario debe autenticarse con Google durante la inscripción. Si se especifica este parámetro de configuración, se ignora el GoogleAuthenticationSettings especificado para el recurso de la empresa en los dispositivos inscritos con este token.

Los valores aceptables son los siguientes:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Opcional] Especifica la Cuenta de Google administrada que el usuario debe usar durante la inscripción. AuthenticationRequirement debe establecerse enREQUIRED if this field is set..