Important : Nous n'acceptons plus de nouvelles inscriptions à l'API EMM Play.
En savoir plus
Users: insert
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Crée un utilisateur géré par EMM.
Ressource Users
transmis dans le corps de la requête doit inclure un
accountIdentifier et accountType.
Si un utilisateur correspondant existe déjà
avec le même identifiant de compte,
l'utilisateur est mis à jour avec la ressource. Dans ce cas, seul le
Le champ displayName peut être modifié.
Requête
Requête HTTP
POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users
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 nécessite une autorisation ayant le champ d'application suivant:
| 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 une ressource "Users" avec les propriétés suivantes:
| Nom de propriété |
Valeur |
Description |
Remarques |
| Propriétés obligatoires |
accountIdentifier |
string |
Identifiant unique que vous créez pour cet utilisateur, par exemple "utilisateur342". ou "asset#44418". N'utilisez pas d'informations permettant d'identifier personnellement l'utilisateur pour cette propriété. Doit toujours être défini pour les utilisateurs gérés par un fournisseur EMM. Non définie pour les utilisateurs gérés par Google. |
|
accountType |
string |
Type de compte représenté par cet utilisateur. Un userAccount peut être installé sur plusieurs appareils, mais un deviceAccount est spécifique à un seul appareil. Un utilisateur géré par EMM (emmManaged) peut être de l'un ou l'autre type (userAccount, deviceAccount), mais un utilisateur géré par Google (googleManaged) est toujours de type userAccount.
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder"></ph>
- "
deviceAccount"
- "
userAccount"
|
|
Réponse
Lorsque cette méthode fonctionne, elle renvoie une ressource "Users" dans le corps de réponse.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eCreates or updates an EMM-managed user within a specified enterprise.\u003c/p\u003e\n"],["\u003cp\u003eRequires an \u003ccode\u003eaccountIdentifier\u003c/code\u003e and \u003ccode\u003eaccountType\u003c/code\u003e to define the user.\u003c/p\u003e\n"],["\u003cp\u003eUses a POST request to the \u003ccode\u003e/enterprises/enterpriseId/users\u003c/code\u003e endpoint.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003edisplayName\u003c/code\u003e is the only field that can be updated for existing users.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidenterprise\u003c/code\u003e scope is necessary.\u003c/p\u003e\n"]]],[],null,["# Users: insert\n\n| **Note:** Requires [authorization](#auth).\n\nCreates a new EMM-managed user.\n\n\u003cbr /\u003e\n\n\nThe [Users](/android/work/play/emm-api/v1/users) resource\npassed in the body of the request should include an\n`accountIdentifier` and an `accountType`.\n\nIf a corresponding user already exists with the same account identifier,\nthe user will be updated with the resource. In this case only the\n`displayName` field can be changed.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/users\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------|\n| **Path parameters** |||\n| `enterpriseId` | `string` | The ID of the enterprise. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/androidenterprise` |\n\nFor more information, see the [authentication and authorization](/android/work/play/emm-api/v1/how-tos/authorizing) page.\n\n### Request body\n\nIn the request body, supply a [Users resource](/android/work/play/emm-api/v1/users#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| **Required Properties** ||||\n| `accountIdentifier` | `string` | A unique identifier you create for this user, such as \"user342\" or \"asset#44418\". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users. | |\n| `accountType` | `string` | The type of account that this user represents. A `userAccount` can be installed on multiple devices, but a `deviceAccount` is specific to a single device. An EMM-managed user (`emmManaged`) can be either type (`userAccount`, `deviceAccount`), but a Google-managed user (`googleManaged`) is always a `userAccount`. \u003cbr /\u003e Acceptable values are: - \"`deviceAccount`\" - \"`userAccount`\" | |\n\nResponse\n--------\n\nIf successful, this method returns a [Users resource](/android/work/play/emm-api/v1/users#resource) in the response body."]]
