Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La liste des méthodes associées à cette ressource est présentée au bas de la page.
Représentations de la ressource
Une ressource Users représente un compte associé à une entreprise. Le compte peut être spécifique à un appareil ou à un utilisateur individuel (qui peut alors l'utiliser sur plusieurs appareils). Le compte peut ne fournir un accès qu'à Google Play d'entreprise ou à d'autres services Google, en fonction du modèle d'identité:
Le modèle d'identité de domaine géré par Google nécessite la synchronisation avec les sources des comptes Google (via primaryEmail).
Le modèle d'identité des comptes Google Play d'entreprise offre aux entreprises un moyen dynamique de créer des comptes utilisateur ou des comptes d'appareils selon les besoins. Ces comptes permettent d'accéder à Google Play d'entreprise.
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"
displayName
string
Nom qui apparaîtra dans les interfaces utilisateur. La définition de cette propriété est facultative lors de la création d'utilisateurs gérés par un fournisseur EMM. Si vous définissez cette propriété, utilisez des informations génériques concernant l'organisation (par exemple, "Example, Inc.") ou votre nom (en tant que fournisseur EMM). Non utilisée pour les comptes utilisateur gérés par Google.
accessible en écriture
id
string
Identifiant unique de l'utilisateur.
kind
string
managementType
string
Entité qui gère l'utilisateur. Pour les utilisateurs googleManaged, la source d'informations est Google. Les EMM doivent donc s'assurer qu'un compte Google existe pour l'utilisateur. Avec emmManaged utilisateurs, c'est l'EMM qui s'occupe de tout.
Les valeurs possibles sont les suivantes:
<ph type="x-smartling-placeholder">
</ph>
"emmManaged"
"googleManaged"
primaryEmail
string
Adresse e-mail principale de l'utilisateur (par exemple, "jdupont@example.com"). Toujours défini pour les utilisateurs gérés par Google, et non pour les utilisateurs gérés par un fournisseur EMM.
Génère un jeton d'authentification que le client Device Policy peut utiliser pour
provisionner le compte utilisateur géré par
EMM en question sur un appareil.
Le jeton généré est à usage unique et expire au bout de quelques minutes.
Vous pouvez provisionner jusqu'à 10 appareils par utilisateur.
Cet appel ne fonctionne qu'avec les comptes gérés 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é.
Recherche un utilisateur à l'aide de son adresse e-mail principale.
Cette option n'est disponible que pour les utilisateurs gérés par Google. La recherche de l'ID n'est pas
nécessaire pour les utilisateurs gérés par un fournisseur EMM, car l'identifiant est déjà renvoyé dans le
de l'appel Users.insert.
Révoque l'accès à tous les appareils actuellement gérés pour l'utilisateur. L'utilisateur
ne pourront plus utiliser le Play Store d'entreprise sur leurs
appareils gérés.
Cet appel ne fonctionne qu'avec les comptes gérés par EMM.
Modifie l'ensemble des produits auxquels un utilisateur est autorisé à accéder (appelé
en tant que produits en liste blanche). Uniquement les produits
approuvé
ou produits ayant déjà été approuvés (produits dont l'approbation a été révoquée)
peuvent être ajoutées à la liste blanche.
Met à jour les détails d'un utilisateur géré par EMM.
Peut être utilisé uniquement avec les utilisateurs gérés par un fournisseur EMM (pas avec les utilisateurs gérés par Google).
Transmettez les nouvelles informations dans la
Utilisateurs
dans le corps de la requête. Uniquement le champ displayName
peuvent être modifiés. Les autres champs ne doivent pas être définis ou doivent comporter la
la valeur actuellement active.
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 2024/08/19 (UTC).
[null,null,["Dernière mise à jour le 2024/08/19 (UTC)."],[[["\u003cp\u003eA Users resource represents an enterprise account that can be device- or individual-specific, granting access to managed Google Play and potentially other Google services based on the chosen identity model.\u003c/p\u003e\n"],["\u003cp\u003eTwo identity models are available: Google-managed domain identity (requiring synchronization with Google accounts) and managed Google Play Accounts (allowing dynamic creation of user/device accounts for Play access).\u003c/p\u003e\n"],["\u003cp\u003eEMM-managed users have unique identifiers and account types, while Google-managed users rely on primary email addresses for identification.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can manage users using various methods like creating, deleting, retrieving details, and controlling device access, with options varying based on management type.\u003c/p\u003e\n"],["\u003cp\u003eSome methods, like \u003ccode\u003egetAvailableProductSet\u003c/code\u003e and \u003ccode\u003esetAvailableProductSet\u003c/code\u003e, are deprecated and will be inaccessible after September 30, 2025, with alternative recommendations available.\u003c/p\u003e\n"]]],[],null,["# Users\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\nA Users resource represents an account associated with an enterprise. The account may be specific to a device or to an individual user (who can then use the account across multiple devices). The account may provide access to managed Google Play only, or to other Google services, depending on the identity model:\n\n- The Google managed domain identity model requires synchronization to Google account sources (via `primaryEmail`).\n- The managed Google Play Accounts identity model provides a dynamic means for enterprises to create user or device accounts as needed. These accounts provide access to managed Google Play.\n\n\u003cbr /\u003e\n\n```text\n{\n \"kind\": \"androidenterprise#user\",\n \"id\": string,\n \"managementType\": string,\n \"accountType\": string,\n \"primaryEmail\": string,\n \"accountIdentifier\": string,\n \"displayName\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\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| `displayName` | `string` | The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as \"Example, Inc.\") or your name (as EMM). Not used for Google-managed user accounts. | writable |\n| `id` | `string` | The unique ID for the user. | |\n| `kind` | `string` | | |\n| `managementType` | `string` | The entity that manages the user. With `googleManaged` users, the source of truth is Google so EMMs have to make sure a Google Account exists for the user. With `emmManaged` users, the EMM is in charge. \u003cbr /\u003e Acceptable values are: - \"`emmManaged`\" - \"`googleManaged`\" | |\n| `primaryEmail` | `string` | The user's primary email address, for example, \"jsmith@example.com\". Will always be set for Google managed users and not set for EMM managed users. | |\n\nMethods\n-------\n\n[delete](/android/work/play/emm-api/v1/users/delete)\n: Deleted an EMM-managed user.\n\n[generateAuthenticationToken](/android/work/play/emm-api/v1/users/generateAuthenticationToken)\n: Generates an authentication token which the device policy client can use to\n provision the given EMM-managed user account on a device.\n The generated token is single-use and expires after a few minutes.\n\n \u003cbr /\u003e\n\n\n You can provision a maximum of 10 devices per user.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[get](/android/work/play/emm-api/v1/users/get)\n: Retrieves a user's details.\n\n[getAvailableProductSet](/android/work/play/emm-api/v1/users/getAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Retrieves the set of products a user is entitled to access.\n\n[insert](/android/work/play/emm-api/v1/users/insert)\n: Creates a new EMM-managed user.\n\n \u003cbr /\u003e\n\n\n The [Users](/android/work/play/emm-api/v1/users) resource\n passed in the body of the request should include an\n `accountIdentifier` and an `accountType`.\n\n If a corresponding user already exists with the same account identifier,\n the user will be updated with the resource. In this case only the\n `displayName` field can be changed.\n\n[list](/android/work/play/emm-api/v1/users/list)\n: Looks up a user by primary email address.\n This is only supported for Google-managed users. Lookup of the id is not\n needed for EMM-managed users because the id is already returned in the\n result of the Users.insert call.\n\n[revokeDeviceAccess](/android/work/play/emm-api/v1/users/revokeDeviceAccess)\n: Revokes access to all devices currently provisioned to the user. The user\n will no longer be able to use the managed Play store on any of their\n managed devices.\n\n \u003cbr /\u003e\n\n\n This call only works with EMM-managed accounts.\n\n[setAvailableProductSet](/android/work/play/emm-api/v1/users/setAvailableProductSet)\n:\n | **Deprecated:** New integrations cannot use this method and can refer to our [new\n | recommendations](/android/work/deprecations#recommended_alternative_2). \n | **This method will no longer be accessible by\n | anyone after September 30, 2025.**\n\n Modifies the set of products that a user is entitled to access (referred to\n as *whitelisted* products). Only products that are\n [approved](/android/work/play/emm-api/v1/products/approve)\n or products that were previously approved (products with revoked approval)\n can be whitelisted.\n\n[update](/android/work/play/emm-api/v1/users/update)\n: Updates the details of an EMM-managed user.\n\n \u003cbr /\u003e\n\n\n Can be used with EMM-managed users only (not Google managed users).\n Pass the new details in the\n [Users](/android/work/play/emm-api/v1/users)\n resource in the request body. Only the `displayName` field\n can be changed. Other fields must either be unset or have the\n currently active value."]]
