Diese Seite wurde von der Cloud Translation API übersetzt.

Method: users.watch

Beobachtet auf Änderungen in der Nutzerliste.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
`domain`	`string` Name der Domain. Füllen Sie dieses Feld aus, damit nur Nutzer aus dieser Domain abgerufen werden. Wenn Sie stattdessen alle Nutzer in einem Kundenfeld mit mehreren Domains zurückgeben möchten, füllen Sie das entsprechende Feld aus.“
`customer`	`string` Die unveränderliche ID des Google Workspace-Kontos. Wenn es sich um ein Konto mit mehreren Domains handelt, füllen Sie dieses Feld anstelle der Domain aus, um alle Nutzer für einen Kunden abzurufen.
`event`	`enum (EventType)` Ereignisse, auf die Sie achten sollten.
`customFieldMask`	`string` Durch Kommas getrennte Liste der Schemanamen. Alle Felder aus diesen Schemas werden abgerufen. Das sollte nur festgelegt werden, wenn Projektion=benutzerdefiniert ist.
`maxResults`	`integer` Maximale Anzahl der zurückzugebenden Ergebnisse;
`orderBy`	`enum (OrderBy)` Spalte zum Sortieren der Ergebnisse
`pageToken`	`string` Token zur Angabe der nächsten Seite in der Liste
`projection`	`enum (Projection)` Welche Teilmenge der Felder für diesen Nutzer abzurufen ist.
`query`	`string` Abfragestringabfrage. Muss das Format „“ haben. Die vollständige Dokumentation finden Sie unter https: //developers.google.com/admin-sdk/directory/v1/guides/search-users.
`showDeleted`	`string` Bei Auswahl von "true" wird die Liste der gelöschten Nutzer abgerufen. (Standardeinstellung: false)
`sortOrder`	`enum (SortOrder)` Gibt an, ob Ergebnisse in aufsteigender oder absteigender Reihenfolge zurückgegeben werden sollen.
`viewType`	`enum (ViewType)` Gibt an, ob die öffentliche Ansicht mit Administratorzugriff oder die gesamte Domain des Nutzers abgerufen werden soll. Weitere Informationen finden Sie im Hilfeartikel Nutzer als Nicht-Administrator abrufen.

Anfragetext

Der Anfragetext enthält eine Instanz von SubscriptionChannel.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von SubscriptionChannel.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

EventType

Typ des Aboereignisses

Enums
`ADD`	Vom Nutzer erstelltes Ereignis
`DELETE`	Ereignis gelöscht
`MAKE_ADMIN`	Änderungsereignis des Nutzeradministratorstatus
`UNDELETE`	Nutzer hat Ereignis wiederhergestellt
`UPDATE`	Ereignis „Nutzer aktualisiert“

OrderBy

Enums
`EMAIL`	Primäre E-Mail-Adresse des Nutzers.
`FAMILY_NAME`	Der Familienname des Nutzers.
`GIVEN_NAME`	Der Vorname des Nutzers.

Projektion

Enums
`BASIC`	Fügen Sie keine benutzerdefinierten Felder für den Nutzer ein.
`CUSTOM`	Benutzerdefinierte Felder aus Schemas aufnehmen, die in customFieldMask erwähnt sind.
`FULL`	Alle mit diesem Nutzer verknüpften Felder einschließen.

SortOrder

Enums
`ASCENDING`	Aufsteigende Reihenfolge.
`DESCENDING`	Absteigend.

Ansichtstyp

Enums
`admin_view`	Die Ergebnisse umfassen sowohl Felder, die nur für Administratoren und für Domains zugänglich sind.
`domain_public`	Die Ergebnisse enthalten nur Felder für den Nutzer, die für andere Nutzer in der Domain öffentlich sichtbar sind.