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 |
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 |
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 |
Ereignisse, auf die Sie achten sollten. |
customFieldMask |
Durch Kommas getrennte Liste der Schemanamen. Alle Felder aus diesen Schemas werden abgerufen. Das sollte nur festgelegt werden, wenn Projektion=benutzerdefiniert ist. |
maxResults |
Maximale Anzahl der zurückzugebenden Ergebnisse; |
orderBy |
Spalte zum Sortieren der Ergebnisse |
pageToken |
Token zur Angabe der nächsten Seite in der Liste |
projection |
Welche Teilmenge der Felder für diesen Nutzer abzurufen ist. |
query |
Abfragestringabfrage. Muss das Format „ |
showDeleted |
Bei Auswahl von "true" wird die Liste der gelöschten Nutzer abgerufen. (Standardeinstellung: false) |
sortOrder |
Gibt an, ob Ergebnisse in aufsteigender oder absteigender Reihenfolge zurückgegeben werden sollen. |
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. |