REST Resource: users

Ressource : Utilisateur

L'API Directory vous permet de créer et de gérer les utilisateurs, les alias et les photos de profil Google des utilisateurs associés à votre compte. Pour en savoir plus sur les tâches courantes, consultez le Guide du développeur pour les comptes utilisateur et le Guide du développeur sur les 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 (UserName) }, "kind": string, "etag": string, "emails": value, "externalIds": value, "relations": value, "aliases": [ string ], "isMailboxSetup": boolean, "customerId": string, "addresses": value, "organizations": value, "lastLoginTime": string, "phones": value, "suspensionReason": string, "thumbnailPhotoUrl": string, "languages": value, "posixAccounts": value, "creationTime": string, "nonEditableAliases": [ string ], "sshPublicKeys": value, "notes": value, "websites": value, "locations": value, "includeInGlobalAddressList": boolean, "keywords": value, "deletionTime": string, "gender": value, "thumbnailPhotoEtag": string, "ims": value, "customSchemas": value, "isEnrolledIn2Sv": boolean, "isEnforcedIn2Sv": boolean, "archived": boolean, "orgUnitPath": string, "recoveryEmail": string, "recoveryPhone": string }

Champs
id	string Identifiant unique de l'utilisateur. Un id utilisateur peut être utilisé comme userKey de l'URI de la requête utilisateur.
primaryEmail	string Adresse e-mail principale de l'utilisateur. Cette propriété est obligatoire dans une demande de création de compte utilisateur. L'identifiant primaryEmail doit être unique et ne peut pas être l'alias d'un autre utilisateur.
password	value (Value format) Stocke le mot de passe du compte utilisateur. Veuillez saisir le mot de passe de l'utilisateur 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. Un mot de passe peut contenir n'importe quelle combinaison de caractères ASCII et doit comporter entre 8 et 100 caractères. Nous vous recommandons d'envoyer le paramètre password sous forme de valeur de hachage encodée en hexadécimal et de définir hashFunction en conséquence. Si hashFunction est spécifié, le mot de passe doit être une clé de hachage valide.
hashFunction	string Stocke le format de hachage de la propriété password. Les valeurs hashFunction suivantes sont autorisées: MD5 : accepte les valeurs simples à encodage hexadécimal. SHA-1 : accepte les valeurs simples à encodage hexadécimal. crypt : conforme à la bibliothèque de cryptage C. Accepte les algorithmes de hachage DES, MD5 (préfixe de hachage $1$), SHA-256 (préfixe de hachage $5$) et SHA-512 (préfixe de hachage $6$). Si des arrondis sont spécifiés dans le préfixe, ils doivent être inférieurs ou égaux à 10 000.
isAdmin	boolean Uniquement en sortie. Indique un utilisateur disposant des droits de super-administrateur. La propriété isAdmin ne peut être modifiée que via l'opération Désigner un utilisateur comme administrateur ( méthode makeAdmin). Si elle est modifiée dans les méthodes insert ou update de l'utilisateur, elle est ignorée par le service d'API.
isDelegatedAdmin	boolean Uniquement en sortie. Indique si l'utilisateur est un administrateur délégué. Les administrateurs délégués sont compatibles avec l'API, mais ne peuvent pas créer ou annuler la suppression d'utilisateurs, ni désigner des administrateurs d'utilisateurs. Ces requêtes sont ignorées par le service d'API. Les rôles et droits des administrateurs sont attribués via la console d'administration.
agreedToTerms	boolean Uniquement en sortie. Cette propriété est true si l'utilisateur s'est connecté pour la première fois et a accepté les conditions d'utilisation.
suspended	boolean Indique si le compte utilisateur est suspendu.
changePasswordAtNextLogin	boolean Indique si l'utilisateur est obligé de modifier son mot de passe à la prochaine connexion. Ce paramètre ne s'applique pas lorsque l'utilisateur se connecte via un fournisseur d'identité tiers.
ipWhitelisted	boolean Si la valeur est true, l'adresse IP de l'utilisateur est soumise à une configuration d'adresse IP allowlist obsolète.
name	object (UserName) Contient le nom et le nom de famille de l'utilisateur, ainsi que la valeur fullName en lecture seule. Le nombre maximal de caractères dans les valeurs givenName et familyName est de 60. En outre, les valeurs de nom acceptent les caractères Unicode/UTF-8 et peuvent contenir des espaces, des lettres (a-z), des chiffres (0-9), des tirets (-), des barres obliques (/) et des points (.). Pour en savoir plus sur les règles d'utilisation des caractères, consultez le Centre d'aide pour l'administration. La taille maximale autorisée pour ce champ est de 1 Ko.
kind	string Uniquement en sortie. Type de ressource d'API. Pour les ressources "Utilisateurs", la valeur est admin#directory#user.
etag	string Uniquement en sortie. ETag de la ressource.
emails	value (Value format) Liste des adresses e-mail de l'utilisateur. La taille de données maximale autorisée est de 10 Ko. Fields emails[].address string Adresse e-mail de l'utilisateur. Cette valeur sert également d'ID d'adresse e-mail. Cette valeur peut correspondre à l'adresse e-mail principale de l'utilisateur ou à un alias. emails[].customType string Si l'adresse e-mail type est custom, cette propriété contient la valeur personnalisée et doit être définie. emails[].primary boolean Indique s'il s'agit de l'adresse e-mail principale de l'utilisateur. Une seule entrée peut être désignée comme entrée principale. emails[].type string Type de compte de messagerie. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: custom, home, other, work.
externalIds	value (Value format) Liste des ID externes de l'utilisateur (ID d'employé ou de réseau, par exemple). La taille de données maximale autorisée est de 2 Ko. Fields externalIds[].customType string Si l'ID externe type est custom, cette propriété contient la valeur personnalisée et doit être définie. externalIds[].type string Type d'ID externe. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: account, custom, customer, login_id, network, organization. externalIds[].value string Valeur de l'ID externe.
relations	value (Value format) Liste des relations de l'utilisateur avec les autres utilisateurs. La taille de données maximale autorisée pour ce champ est de 2 Ko. Pour en savoir plus, consultez Gérer les comptes utilisateur. Fields relations[].customType string Si la relation type est custom, cette propriété contient la valeur personnalisée et doit être définie. relations[].type string Type de relation. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: admin_assistant assistant brother child custom domestic_partner dotted_line_manager exec_assistant father friend manager mother parent partner referred_by relative sister spouse relations[].value string Adresse e-mail de la personne à qui l'utilisateur est lié.
aliases[]	string Uniquement en sortie. Liste des alias d'adresses e-mail de l'utilisateur.
isMailboxSetup	boolean Uniquement en sortie. Indique si la boîte aux lettres Google de l'utilisateur a été créée. Cette propriété ne s'applique que si une licence Gmail a été attribuée à l'utilisateur.
customerId	string Uniquement en sortie. Numéro client permettant de récupérer tous les utilisateurs du compte. Vous pouvez utiliser l'alias my_customer pour représenter le customerId de votre compte. En tant qu'administrateur revendeur, vous pouvez utiliser le customerId du compte client indirect. Pour obtenir un customerId, utilisez le domaine principal du compte dans le paramètre domain d'une requête users.list.
addresses	value (Value format) Liste des adresses de l'utilisateur. La taille de données maximale autorisée est de 10 Ko. Fields addresses[].country string Pays. addresses[].countryCode string Le code pays. Utilise la norme ISO 3166-1. addresses[].customType string Si l'adresse type est custom, cette propriété contient la valeur personnalisée et doit être définie. addresses[].extendedAddress string Pour les adresses étendues, telles qu'une adresse qui inclut une sous-région. addresses[].formatted string Adresse postale complète et non structurée. Ceci n'est pas synchronisé avec les champs d'adresse structurés. Inclut les attributs suivants: adresse postale, boîte postale, ville, État/province, code postal, pays/région. addresses[].locality string Ville de l'adresse. addresses[].poBox string Boîte postale, le cas échéant addresses[].postalCode string Code postal, le cas échéant. addresses[].primary boolean S'il s'agit de l'adresse principale de l'utilisateur. La liste d'adresses ne peut contenir qu'une seule adresse principale. addresses[].region string Province ou État abrégé. addresses[].sourceIsStructured boolean Indique si l'adresse fournie par l'utilisateur a été mise en forme. Les adresses formatées ne sont pas acceptées pour le moment. addresses[].streetAddress string Adresse postale, par exemple 1600 Amphitheatre Parkway. Les espaces blancs dans la chaîne sont ignorés. Toutefois, les sauts de ligne sont importants. addresses[].type string Type d'adresse. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: custom, home, other, work.
organizations	value (Value format) Liste des organisations auxquelles appartient l'utilisateur. La taille de données maximale autorisée est de 10 Ko. Fields organizations[].costCenter string Centre de coûts de l'organisation de l'utilisateur. organizations[].customType string Si la valeur du type est "personnalisée", cette propriété contient le type personnalisé. organizations[].department string Spécifie le service au sein de l'organisation, par exemple sales ou engineering. organizations[].description string Description de l'organisation. organizations[].domain string Domaine auquel appartient l'organisation. organizations[].fullTimeEquivalent integer Équivalent à temps plein au sein de l'organisation (100 000 = 100%). organizations[].location string Emplacement physique de l'organisation. Il ne doit pas nécessairement s'agir d'une adresse complète. organizations[].name string Nom de l'organisme. organizations[].primary boolean Indique s'il s'agit de l'organisation principale de l'utilisateur. Un utilisateur ne peut avoir qu'une seule organisation principale. organizations[].symbol string Symbole de la chaîne de texte de l'organisation. Par exemple, le symbole textuel de Google est GOOG. organizations[].title string Fonction de l'utilisateur au sein de l'organisation. Par exemple, member ou engineer. organizations[].type string Type d'organisation. Valeurs acceptées: domain_only, school, unknown, work.
lastLoginTime	string Uniquement en sortie. Date 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, minutes et secondes, au format YYYY-MM-DDThh:mm:ssTZD. Exemple : 2010-04-05T17:30:04+01:00.
phones	value (Value format) Liste des numéros de téléphone de l'utilisateur. La taille de données maximale autorisée est de 1 Ko. Fields phones[].customType string Si le numéro de téléphone type est custom, cette propriété contient la valeur personnalisée et doit être définie. phones[].primary boolean Si true, il s'agit du numéro de téléphone principal de l'utilisateur. Un utilisateur ne peut avoir qu'un seul numéro de téléphone principal. phones[].type string Type de numéro de téléphone. Si la valeur est custom, customType doit également être défini. Valeurs acceptées: assistant, callback, car, company_main, custom, grand_central, home, home_fax, isdn, main, mobile, other, other_fax, pager, radio, telex, tty_tdd, work, work_mobile, work_mobile.work_faxwork_pager phones[].value string Numéro de téléphone intelligible. Vous pouvez utiliser n'importe quel format de numéro de téléphone.
suspensionReason	string Uniquement en sortie. Le motif de la suspension du compte utilisateur est soit par l'administrateur, soit par Google au moment de la suspension. La propriété n'est renvoyée que si la propriété suspended est true.
thumbnailPhotoUrl	string Uniquement en sortie. URL de la photo du profil de l'utilisateur. L'URL est peut-être temporaire ou privée.
languages	value (Value format) Liste des langues de l'utilisateur. La taille de données maximale autorisée est de 1 Ko. Fields languages[].customLanguage string Autre langue. L'utilisateur peut indiquer son propre nom de langue en l'absence de code de langue ISO 639 correspondant. Si cette option est définie, languageCode ne peut pas être configurée. languages[].languageCode string Représentation d'une langue sous forme de chaîne ISO 639. Consultez la section Codes de langue pour obtenir la liste des codes acceptés. Les codes de langue valides en dehors de l'ensemble accepté seront acceptés par l'API, mais cela peut entraîner un comportement inattendu. Des valeurs non valides entraînent l'erreur suivante : SchemaException. Si cette option est définie, customLanguage ne peut pas être configurée. languages[].preference string Facultatif. S'il est présent, détermine si la languageCode spécifiée est la langue préférée de l'utilisateur. Vous ne pouvez pas définir ce paramètre si customLanguage est défini. Les valeurs autorisées sont preferred et not_preferred.
posixAccounts	value (Value format) Liste des informations de compte POSIX de l'utilisateur. Fields posixAccounts[].accountId string Identifiant de champ de compte POSIX. posixAccounts[].gecos string GECOS (informations sur l'utilisateur) pour ce compte. posixAccounts[].gid unsigned long ID du groupe par défaut. posixAccounts[].homeDirectory string Chemin d'accès au répertoire d'accueil de ce compte. posixAccounts[].operatingSystemType string Type de système d'exploitation associé à ce compte. Valeurs acceptées: linux, unspecified, windows. posixAccounts[].primary boolean S'il s'agit du compte principal de l'utilisateur dans SystemId. posixAccounts[].shell string Chemin d'accès au shell de connexion pour ce compte. posixAccounts[].systemId string Identifiant système auquel le nom d'utilisateur ou l'UID de compte s'appliquent. posixAccounts[].uid unsigned long ID utilisateur compatible avec POSIX. posixAccounts[].username string Nom d'utilisateur du compte.
creationTime	string 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 YYYY-MM-DDThh:mm:ssTZD. Exemple : 2010-04-05T17:30:04+01:00.
nonEditableAliases[]	string Uniquement en sortie. Liste des alias d'adresses e-mail non modifiables de l'utilisateur. Ceux-ci sont généralement en dehors du domaine principal ou du sous-domaine du compte.
sshPublicKeys	value (Value format) Une liste de clés publiques SSH Fields sshPublicKeys[].expirationTimeUsec long Délai d'expiration en microsecondes depuis l'époque. sshPublicKeys[].fingerprint string Empreinte SHA-256 de la clé publique SSH. (Lecture seule) sshPublicKeys[].key string Une clé publique SSH
notes	value (Value format) Notes destinées à l'utilisateur en tant qu'objet imbriqué. Fields notes.contentType string Type de contenu de la note, soit texte brut, soit HTML. La valeur par défaut est "Texte brut". Valeurs acceptées: text_plain, text_html. notes.value string Contenu des notes.
websites	value (Value format) Liste des sites Web de l'utilisateur. Fields websites[].customType string Si le site Web type est défini sur custom, cette propriété contient la valeur personnalisée et doit être définie. websites[].primary boolean Si la valeur est true, il s'agit du site Web principal de l'utilisateur. websites[].type string Type ou objectif du site Web. Par exemple, un site Web peut être libellé home ou blog. Une entrée peut également avoir un type custom. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: app_install_page, blog, custom, ftp, home, home_page, other, profile, reservations, resume, work. websites[].value string URL du site Web.
locations	value (Value format) Liste des zones géographiques de l'utilisateur. La taille de données maximale autorisée est de 10 Ko. Fields locations[].area string Emplacement textuel. Cette option est particulièrement utile pour décrire le lieu de manière concise. Par exemple, Mountain View, CA ou Near Seattle. locations[].buildingId string Identifiant du bâtiment. locations[].customType string Si l'emplacement type est custom, cette propriété contient la valeur personnalisée et doit être définie. locations[].deskCode string Code textuel le plus spécifique de l'emplacement d'un bureau individuel. locations[].floorName string Nom/numéro de l'étage. locations[].floorSection string Section de l'étage. Emplacement plus spécifique de l'étage. Par exemple, si un étage est divisé en sections A, B et C, ce champ identifie l'une de ces valeurs. locations[].type string Type d'emplacement. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: custom, default, desk.
includeInGlobalAddressList	boolean Indique si le profil de l'utilisateur est visible dans la liste d'adresses globale de Google Workspace lorsque la fonctionnalité de partage des contacts est activée pour le domaine. Pour plus d'informations sur l'exclusion de profils utilisateur, consultez le Centre d'aide pour l'administration.
keywords	value (Value format) Liste des mots clés de l'utilisateur. La taille de données maximale autorisée est de 1 Ko. Fields keywords[].customType string Si le mot clé type est custom, cette propriété contient la valeur personnalisée et doit être définie. keywords[].type string Chaque entrée peut avoir un type qui indique le type standard de cette entrée. Par exemple, un mot clé peut être de type occupation ou outlook. En plus du type standard, une entrée peut avoir le type custom et lui attribuer n'importe quel nom. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: custom, mission, occupation, outlook. keywords[].value string Mot clé.
deletionTime	string 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 YYYY-MM-DDThh:mm:ssTZD. Par exemple : 2010-04-05T17:30:04+01:00
gender	value (Value format) Objet imbriqué contenant le genre de l'utilisateur. La taille maximale autorisée pour ce champ est de 1 Ko. Fields gender.addressMeAs string Chaîne de texte indiquant la manière appropriée de désigner le propriétaire du profil par les humains, par exemple "il/lui/son" ou "il/lui/leur". gender.customGender string Nom d'un genre personnalisé. gender.type string Type de genre. Valeurs acceptées: female male other unknown
thumbnailPhotoEtag	string Uniquement en sortie. ETag de la photo de l'utilisateur (lecture seule)
ims	value (Value format) Comptes de messagerie instantanée de l'utilisateur. Un compte utilisateur peut avoir plusieurs propriétés ims, mais une seule de ces propriétés ims peut être le contact principal de la messagerie instantanée. Fields ims[].customProtocol string Si la valeur du protocole est custom_protocol, cette propriété contient la chaîne du protocole personnalisé. ims[].customType string Si le type de messagerie instantanée est défini sur custom, cette propriété contient la valeur personnalisée et doit être définie. ims[].im string ID de réseau de messagerie instantanée de l'utilisateur. ims[].primary boolean S'il s'agit du chat principal de l'utilisateur. Une seule entrée de la liste du gestionnaire d'inventaire peut avoir la valeur "true". ims[].protocol string Le protocole de messagerie instantanée identifie le réseau de messagerie instantanée. La valeur peut être un réseau personnalisé ou le réseau standard. Valeurs acceptées: aim: protocole AOL Instant Messenger custom_protocol: protocole réseau de messagerie instantanée personnalisé gtalk: protocole Google Talk icq: protocole ICQ jabber: protocole Jabber msn: protocoleMS Messenger net_meeting: protocole Net Meeting qq: protocole QQ skype: protocole Skype yahoo: protocole Yahoo Messenger ims[].type string Type de compte de messagerie instantanée. Si la valeur est custom, customType doit également être définie. Valeurs acceptées: custom, home, other, work.
customSchemas	value (Value format) Champs personnalisés de l'utilisateur. La clé est une schemaName et ses valeurs sont 'fieldName': 'field_value'. customSchemas.(key) est un objet imbriqué. customSchemas.(key).(key) peut correspondre à n'importe quelle valeur.
isEnrolledIn2Sv	boolean Uniquement en sortie. Utilise la validation en deux étapes (lecture seule)
isEnforcedIn2Sv	boolean Uniquement en sortie. Validation en deux étapes appliquée (lecture seule)
archived	boolean Indique si l'utilisateur est archivé.
orgUnitPath	string Chemin d'accès complet de l'organisation parente associée à l'utilisateur. Si l'organisation parente est l'organisation racine, elle est représentée par une barre oblique (/).
recoveryEmail	string Adresse e-mail de récupération de l'utilisateur.
recoveryPhone	string 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: [phone].

UserName

Représentation JSON
{ "fullName": string, "familyName": string, "givenName": string, "displayName": string }

Champs
fullName	string Nom complet de l'utilisateur formé en concaténant les valeurs de prénom et de nom.
familyName	string Nom de famille de l'utilisateur Obligatoire lors de la création d'un compte utilisateur.
givenName	string Prénom de l'utilisateur. Obligatoire lors de la création d'un compte utilisateur.
displayName	string Nom à afficher de l'utilisateur. Limite: 256 caractères.

Méthodes
delete	Supprime un utilisateur.
get	Récupère un utilisateur.
insert	Crée un utilisateur.
list	Récupère une liste paginée des utilisateurs supprimés ou de tous les utilisateurs d'un domaine.
makeAdmin	Affecte un utilisateur au rôle de super-administrateur.
patch	Met à jour un utilisateur à l'aide de la sémantique patch.
signOut	Permet à l'utilisateur de se déconnecter de toutes ses sessions sur le Web et sur son appareil, et de réinitialiser ses cookies de connexion.
undelete	Annule la suppression d'un compte utilisateur.
update	Met à jour un utilisateur.
watch	Surveille les modifications apportées à la liste des utilisateurs.