Cette page a été traduite par l'API Cloud Translation.

Method: users.watch

Surveillez les changements dans la liste des utilisateurs.

Requête HTTP :

POST https://admin.googleapis.com/admin/directory/v1/users/watch

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
`domain`	`string` Nom du domaine. Remplissez ce champ pour récupérer uniquement les utilisateurs de ce domaine. Pour renvoyer tous les utilisateurs dans un champ de client multi-domaine."
`customer`	`string` ID immuable du compte Google Workspace. Dans le cas d'un domaine multidomaine, indiquez tous les utilisateurs d'un client en complétant ce champ au lieu du domaine.
`event`	`enum (EventType)` Événements à surveiller.
`customFieldMask`	`string` Liste de noms de schémas séparés par une virgule. Tous les champs de ces schémas sont extraits. Ce champ ne doit être défini que si projection=custom.
`maxResults`	`integer` Nombre maximal de résultats sur une page.
`orderBy`	`enum (OrderBy)` Colonne à utiliser pour trier les résultats
`pageToken`	`string` Jeton permettant de spécifier la page suivante dans la liste.
`projection`	`enum (Projection)` Sous-ensemble de champs à récupérer pour cet utilisateur.
`query`	`string` Recherche de chaînes de requête. Doit être au format "". La documentation complète est disponible à l'adresse suivante: //developers.google.com/admin-sdk/directory/v1/guides/search-users
`showDeleted`	`string` Si la valeur est définie sur "true", la liste des utilisateurs supprimés est récupérée. (Valeur par défaut: false)
`sortOrder`	`enum (SortOrder)` Renvoie les résultats par ordre croissant ou décroissant.
`viewType`	`enum (ViewType)` Permet de récupérer la vue publique de l'utilisateur pour les administrateurs ou le domaine. Pour en savoir plus, consultez Récupérer un utilisateur en tant qu'administrateur.

Corps de la requête

Le corps de la requête contient une instance SubscriptionChannel.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de SubscriptionChannel.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

https://www.googleapis.com/auth/admin.directory.user
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez le guide sur les autorisations.

EventType

Type d'abonnement

Enums
`ADD`	Événement créé par l'utilisateur
`DELETE`	Événement supprimé par l'utilisateur
`MAKE_ADMIN`	Événement de changement de l'état d'administration de l'utilisateur
`UNDELETE`	Événement rétabli par l'utilisateur
`UPDATE`	Événement mis à jour par l'utilisateur

OrderBy

Enums
`EMAIL`	Adresse e-mail principale de l'utilisateur.
`FAMILY_NAME`	Nom de famille de l'utilisateur.
`GIVEN_NAME`	Nom de l'utilisateur.

Projection

Enums
`BASIC`	N'incluez aucun champ personnalisé pour l'utilisateur.
`CUSTOM`	Incluez des champs personnalisés à partir des schémas mentionnés dans customFieldMask.
`FULL`	Incluez tous les champs associés à cet utilisateur.

SortOrder

Enums
`ASCENDING`	Ordre croissant.
`DESCENDING`	Ordre décroissant.

Type de vue

Enums
`admin_view`	Les résultats incluent à la fois les champs réservés aux administrateurs et les domaines publics.
`domain_public`	Les résultats n'incluent que les champs de l'utilisateur visibles publiquement par les autres utilisateurs du domaine.