Ressource : Utilisateur
L'API Directory vous permet de créer et de gérer les utilisateurs, les alias utilisateur et les photos de profil Google de votre compte. Pour en savoir plus sur les tâches courantes, consultez le Guide du développeur de comptes utilisateur et le Guide du développeur relatif aux alias d'utilisateur.
Représentation JSON |
---|
{
"id": string,
"primaryEmail": string,
"password": value,
"hashFunction": string,
"isAdmin": boolean,
"isDelegatedAdmin": boolean,
"agreedToTerms": boolean,
"suspended": boolean,
"changePasswordAtNextLogin": boolean,
"ipWhitelisted": boolean,
"name": {
object ( |
Champs | |||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
Identifiant unique de l'utilisateur. Un |
||||||||||||||||||||||||||||||||||||||||||
primaryEmail |
Adresse e-mail principale de l'utilisateur. Cette propriété est obligatoire dans une requête de création de compte utilisateur. L' |
||||||||||||||||||||||||||||||||||||||||||
password |
Stocke le mot de passe du compte utilisateur. La valeur du mot de passe de l'utilisateur est requise lors de la création d'un compte utilisateur. Il est facultatif lors de la mise à jour d'un utilisateur et ne doit être fourni que si l'utilisateur modifie le mot de passe de son compte. La valeur du mot de passe n'est jamais renvoyée dans le corps de la réponse de l'API. |
||||||||||||||||||||||||||||||||||||||||||
hashFunction |
Stocke le format de hachage de la propriété
Si des arrondis sont spécifiés dans le préfixe, ils ne doivent pas dépasser 10 000. |
||||||||||||||||||||||||||||||||||||||||||
isAdmin |
Uniquement en sortie. Indique un utilisateur disposant de droits de super-administrateur. La propriété |
||||||||||||||||||||||||||||||||||||||||||
isDelegatedAdmin |
Uniquement en sortie. Indique si l'utilisateur est un administrateur délégué. |
||||||||||||||||||||||||||||||||||||||||||
agreedToTerms |
Uniquement en sortie. Cette propriété est |
||||||||||||||||||||||||||||||||||||||||||
suspended |
Indique si l'utilisateur est suspendu. |
||||||||||||||||||||||||||||||||||||||||||
changePasswordAtNextLogin |
Indique si l'utilisateur doit modifier son mot de passe lors de sa prochaine connexion. Ce paramètre ne s'applique pas lorsque l'utilisateur se connecte via un fournisseur d'identité tiers. |
||||||||||||||||||||||||||||||||||||||||||
ipWhitelisted |
Si la valeur est |
||||||||||||||||||||||||||||||||||||||||||
name |
Contient le nom et le nom de famille de l'utilisateur, ainsi que la valeur |
||||||||||||||||||||||||||||||||||||||||||
kind |
Uniquement en sortie. Type de ressource d'API. Pour les ressources "Utilisateurs", la valeur est |
||||||||||||||||||||||||||||||||||||||||||
etag |
Uniquement en sortie. ETag de la ressource. |
||||||||||||||||||||||||||||||||||||||||||
emails |
Liste des adresses e-mail de l'utilisateur. La taille maximale autorisée pour les données est de 10 Ko.
|
||||||||||||||||||||||||||||||||||||||||||
externalIds |
Liste des ID externes de l'utilisateur, tels qu'un ID d'employé ou de réseau. La taille maximale de données autorisée est de 2 ko.
|
||||||||||||||||||||||||||||||||||||||||||
relations |
Liste des relations de l'utilisateur avec d'autres utilisateurs. La taille maximale de données autorisée pour ce champ est de 2 Ko. Pour en savoir plus, consultez Gérer les comptes utilisateur.
|
||||||||||||||||||||||||||||||||||||||||||
aliases[] |
Uniquement en sortie. Liste des adresses e-mail d'alias de l'utilisateur. |
||||||||||||||||||||||||||||||||||||||||||
isMailboxSetup |
Uniquement en sortie. Indique si la boîte de messagerie Google de l'utilisateur est créée. Cette propriété n'est applicable que si une licence Gmail a été attribuée à l'utilisateur. |
||||||||||||||||||||||||||||||||||||||||||
customerId |
Uniquement en sortie. ID client permettant de récupérer tous les utilisateurs du compte. |
||||||||||||||||||||||||||||||||||||||||||
addresses |
Liste des adresses de l'utilisateur. La taille maximale autorisée pour les données est de 10 Ko.
|
||||||||||||||||||||||||||||||||||||||||||
organizations |
Liste des organisations auxquelles l'utilisateur appartient. La taille maximale autorisée des données est de 10 Ko.
|
||||||||||||||||||||||||||||||||||||||||||
lastLoginTime |
Uniquement en sortie. Date et heure de la dernière connexion de l'utilisateur à son compte La valeur est au format de date et d'heure ISO 8601. L'heure correspond à la date complète suivie des heures, des minutes et des secondes, au format |
||||||||||||||||||||||||||||||||||||||||||
phones |
Liste des numéros de téléphone de l'utilisateur. La taille maximale de données autorisée est de 1 Ko.
|
||||||||||||||||||||||||||||||||||||||||||
suspensionReason |
Uniquement en sortie. Indique le motif de suspension d'un compte utilisateur par l'administrateur ou par Google au moment de la suspension. La propriété n'est renvoyée que si la propriété |
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoUrl |
Uniquement en sortie. URL de la photo de profil de l'utilisateur. L'URL peut être temporaire ou privée. |
||||||||||||||||||||||||||||||||||||||||||
languages |
Liste des langues de l'utilisateur. La taille maximale de données autorisée est de 1 Ko.
|
||||||||||||||||||||||||||||||||||||||||||
posixAccounts |
Liste des informations de compte POSIX de l'utilisateur.
|
||||||||||||||||||||||||||||||||||||||||||
creationTime |
Uniquement en sortie. Heure de création du compte de l'utilisateur. La valeur est au format de date et d'heure ISO 8601. L'heure correspond à la date complète, suivie des heures, minutes et secondes au format |
||||||||||||||||||||||||||||||||||||||||||
nonEditableAliases[] |
Uniquement en sortie. Liste des adresses e-mail d'alias non modifiables de l'utilisateur. Il s'agit généralement de domaines ou de sous-domaines externes au domaine principal du compte. |
||||||||||||||||||||||||||||||||||||||||||
sshPublicKeys |
Liste de clés publiques SSH.
|
||||||||||||||||||||||||||||||||||||||||||
notes |
Remarques pour l'utilisateur sous forme d'objet imbriqué.
|
||||||||||||||||||||||||||||||||||||||||||
websites |
Liste des sites Web de l'utilisateur.
|
||||||||||||||||||||||||||||||||||||||||||
locations |
Liste des lieux de l'utilisateur. La taille maximale autorisée des données est de 10 Ko.
|
||||||||||||||||||||||||||||||||||||||||||
includeInGlobalAddressList |
Indique si le profil de l'utilisateur est visible dans la liste d'adresses globale Google Workspace lorsque la fonctionnalité de partage de contacts est activée pour le domaine. Pour en savoir plus sur l'exclusion de profils utilisateur, consultez le Centre d'aide pour les administrateurs. |
||||||||||||||||||||||||||||||||||||||||||
keywords |
Liste des mots clés de l'utilisateur. La taille maximale de données autorisée est de 1 Ko.
|
||||||||||||||||||||||||||||||||||||||||||
deletionTime |
Uniquement en sortie. Heure à laquelle le compte de l'utilisateur a été supprimé. La valeur est au format de date et d'heure ISO 8601. L'heure correspond à la date complète, suivie des heures, minutes et secondes au format |
||||||||||||||||||||||||||||||||||||||||||
gender |
Objet imbriqué contenant le genre de l'utilisateur. La taille maximale de données autorisée pour ce champ est de 1 ko.
|
||||||||||||||||||||||||||||||||||||||||||
thumbnailPhotoEtag |
Uniquement en sortie. ETag de la photo de l'utilisateur (lecture seule) |
||||||||||||||||||||||||||||||||||||||||||
ims |
Les comptes de messagerie instantanée (IM) de l'utilisateur. Un compte utilisateur peut avoir plusieurs propriétés
|
||||||||||||||||||||||||||||||||||||||||||
customSchemas |
Champs personnalisés de l'utilisateur. La clé est un
|
||||||||||||||||||||||||||||||||||||||||||
isEnrolledIn2Sv |
Uniquement en sortie. Est inscrit à la validation en deux étapes (lecture seule) |
||||||||||||||||||||||||||||||||||||||||||
isEnforcedIn2Sv |
Uniquement en sortie. La validation en deux étapes est-elle obligatoire ? (lecture seule) |
||||||||||||||||||||||||||||||||||||||||||
archived |
Indique si l'utilisateur est archivé. |
||||||||||||||||||||||||||||||||||||||||||
orgUnitPath |
Chemin d'accès complet de l'organisation parente associée à l'utilisateur. Si l'organisation parente est de niveau supérieur, elle est représentée par une barre oblique ( |
||||||||||||||||||||||||||||||||||||||||||
recoveryEmail |
Adresse e-mail de récupération de l'utilisateur. |
||||||||||||||||||||||||||||||||||||||||||
recoveryPhone |
Numéro de téléphone de récupération de l'utilisateur. Le numéro de téléphone doit être au format E.164 et commencer par le signe plus (+). Exemple: +16506661212. |
UserName
Représentation JSON |
---|
{ "fullName": string, "familyName": string, "givenName": string, "displayName": string } |
Champs | |
---|---|
fullName |
Nom complet de l'utilisateur formé en concaténant les valeurs de prénom et de nom. |
familyName |
Nom de l'utilisateur. Obligatoire lors de la création d'un compte utilisateur. |
givenName |
Prénom de l'utilisateur. Obligatoire lors de la création d'un compte utilisateur. |
displayName |
Nom à afficher de l'utilisateur. Limite: 256 caractères. |
Méthodes |
|
---|---|
|
Supprime un utilisateur. |
|
Récupère un utilisateur. |
|
Crée un utilisateur. |
|
Récupère une liste paginée d'utilisateurs supprimés ou de tous les utilisateurs d'un domaine. |
|
Désigne un utilisateur comme super-administrateur. |
|
Met à jour un utilisateur à l'aide de la sémantique patch. |
|
Déconnecte un utilisateur de toutes les sessions sur le Web et sur l'appareil, et réinitialise ses cookies de connexion. |
|
Réactive un utilisateur supprimé. |
|
Met à jour un utilisateur. |
|
Surveille les modifications apportées à la liste des utilisateurs. |