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:
|
|
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:
|
|
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:
|
|
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:
|
|
googleAuthenticationOptions.requiredAccountEmail |
string |
[Opcional] Especifica la Cuenta de Google administrada que el usuario debe usar durante la inscripción. AuthenticationRequirement debe establecerse enREQUIRED . |