Users

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 ensuite l'utiliser sur plusieurs appareils). Le compte peut donner accès uniquement à Google Play d'entreprise ou à d'autres services Google, selon le modèle d'identité:

  • Le modèle d'identité de domaine géré par Google nécessite une synchronisation avec les sources du compte Google (via primaryEmail).
  • Le modèle d'identité Google Play Accounts offre aux entreprises un moyen dynamique de créer des comptes utilisateur ou des appareils selon leurs besoins. Ces comptes permettent d'accéder à Google Play d'entreprise.

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
Nom de propriété Valeur Description Remarques
accountIdentifier string Identifiant unique que vous avez créé pour cet utilisateur (par exemple, "user342" ou "asset#44418"). N'utilisez pas d'informations personnelles 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 l'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 type (userAccount, deviceAccount), mais un utilisateur géré par Google (googleManaged) est toujours un userAccount.

Les valeurs autorisées sont les suivantes :
  • "deviceAccount"
  • "userAccount"
displayName string Nom qui apparaîtra dans les interfaces utilisateur. Cette propriété est facultative lorsque vous créez des utilisateurs gérés par un fournisseur EMM. Si vous définissez cette propriété, utilisez un nom générique (par exemple, "Example, Inc.") ou votre nom ("EMM"). Non utilisé pour les comptes utilisateur gérés par Google. accessible en écriture
id string ID unique de l'utilisateur.

kind string
managementType string Entité qui gère l'utilisateur. Avec googleManaged utilisateurs, Google est la source d'informations fiable. Les fournisseurs EMM doivent donc s'assurer qu'ils disposent d'un compte Google. Avec emmManaged utilisateurs, le fournisseur EMM est en charge.

Les valeurs autorisées sont les suivantes :
  • "emmManaged"
  • "googleManaged"
primaryEmail string Adresse e-mail principale de l'utilisateur, par exemple "jdupont@example.com". Elle sera toujours définie pour les utilisateurs gérés par Google, et non pour les utilisateurs EMM gérés.

Méthodes

supprimer
Un utilisateur géré par un fournisseur EMM a été supprimé.
generateAuthenticationToken
Génère un jeton d'authentification que le client des règles relatives aux appareils peut utiliser pour provisionner le compte utilisateur géré par EMM 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.
obtenir
Récupère les informations sur l'utilisateur.
getAvailableProductSet
Récupère l'ensemble des produits auxquels un utilisateur a accès. Remarque: Cet élément est obsolète. Les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent faire référence à nos nouvelles recommandations.
insérer
Crée un utilisateur géré par un fournisseur EMM.

La ressource Users transmise dans le corps de la requête doit inclure un accountIdentifier et un accountType.

Si un utilisateur correspondant existe déjà avec le même identifiant de compte, il sera mis à jour avec la ressource. Dans ce cas, seul le champ displayName peut être modifié.

list
Recherche un utilisateur en fonction 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 EMM, car l'ID est déjà renvoyé dans le résultat de l'appel Users.insert.
revokeDeviceAccess
Révoque l'accès à tous les appareils actuellement gérés à l'utilisateur. L'utilisateur ne pourra plus utiliser le Play Store d'entreprise sur aucun de ses appareils gérés.

Cet appel ne fonctionne qu'avec les comptes gérés par EMM.
setAvailableProductSet
Modifie l'ensemble des produits auxquels l'utilisateur a accès (appelés produits en liste blanche). Seuls les produits approuvés ou les produits précédemment approuvés (produits dont l'approbation a été révoquée) peuvent être ajoutés à la liste blanche. Remarque: Cet élément est obsolète. Les nouvelles intégrations ne peuvent pas utiliser cette méthode et peuvent faire référence à nos nouvelles recommandations.
mettre à jour
Met à jour les informations d'un utilisateur géré par un fournisseur EMM.

Cette option est réservée aux utilisateurs gérés par un fournisseur EMM (pas Google). Transmettez les nouveaux détails de la ressource Users dans le corps de la requête. Seul le champ displayName peut être modifié. Les autres champs doivent être non définis ou avoir la valeur actuellement active.