Enrollmenttokens: create

Crée un jeton d'inscription pour l'entreprise. Cette méthode fait partie de EnrollmentTokensService.

Requête

Requête HTTP

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

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
enterpriseId string ID de l'entreprise.

Autorisation

Cette requête requiert une autorisation ayant la portée suivante :

Champ d'application
https://www.googleapis.com/auth/androidenterprise

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Dans le corps de la requête, indiquez des données en utilisant la structure suivante :

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nom de propriété Valeur Description Remarques
kind string
token string Valeur du jeton transmise à l'appareil et qui l'autorise à s'inscrire. Il s'agit d'un champ en lecture seule généré par le serveur.
enrollmentTokenType string [Obligatoire] Type de jeton d'inscription.

Les valeurs acceptables sont les suivantes :
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Facultatif] Durée de validité du jeton d'inscription, allant de 1 minute à Durations.MAX_VALUE, soit environ 10 000 ans. Si aucune valeur n'est spécifiée, la durée par défaut est de 1 heure. Dans l'API REST JSON, elle est représentée sous forme de chaîne (par exemple, `3600s`).
duration.seconds long Secondes signées de la période.
googleAuthenticationOptions nested object [Facultatif] Fournit des options liées à l'authentification Google lors de l'inscription.
googleAuthenticationOptions.authenticationRequirement string [Facultatif] Indique si l'utilisateur doit s'authentifier auprès de Google lors de l'inscription. Si cette option est fournie, elle remplace les GoogleAuthenticationSettings de la ressource d'entreprise lorsque les appareils sont inscrits avec ce jeton.

Les valeurs acceptables sont les suivantes :
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Facultatif] Spécifie le compte Google géré que l'utilisateur doit utiliser lors de l'inscription. AuthenticationRequirement doit être défini sur REQUIRED si ce champ est défini.

Réponse

Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Nom de propriété Valeur Description Remarques
kind string
token string Valeur du jeton transmise à l'appareil et qui l'autorise à s'inscrire. Il s'agit d'un champ en lecture seule généré par le serveur.
enrollmentTokenType string [Obligatoire] Type de jeton d'inscription.

Les valeurs acceptables sont les suivantes :
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Facultatif] Durée de validité du jeton d'inscription, allant de 1 minute à Durations.MAX_VALUE, soit environ 10 000 ans. Si aucune valeur n'est spécifiée, la durée par défaut est de 1 heure. Dans l'API REST JSON, elle est représentée sous forme de chaîne (par exemple, `3600s`).
duration.seconds long Secondes signées de la période.
googleAuthenticationOptions nested object [Facultatif] Fournit des options liées à l'authentification Google lors de l'inscription.
googleAuthenticationOptions.authenticationRequirement string [Facultatif] Indique si l'utilisateur doit s'authentifier auprès de Google lors de l'inscription. Si ce paramètre est spécifié, les GoogleAuthenticationSettings spécifiés pour la ressource d'entreprise sont ignorés pour les appareils inscrits avec ce jeton.

Les valeurs acceptables sont les suivantes :
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Facultatif] Spécifie le compte Google géré que l'utilisateur doit utiliser lors de l'inscription.AuthenticationRequirement doit être défini surREQUIRED if this field is set.