Method: users.watch

Überwacht Ä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, um nur Nutzer aus dieser Domain zu erhalten. Wenn Sie alle Nutzer in einer Multi-Domain-Umgebung zurückgeben möchten, füllen Sie stattdessen das Kundenfeld aus.“
customer

string

Unveränderliche ID des Google Workspace-Kontos. Bei mehreren Domains füllen Sie dieses Feld anstelle von „domain“ aus, um alle Nutzer für einen Kunden abzurufen.
event

enum (EventType)

Wichtige Ereignisse
customFieldMask

string

Durch Kommas getrennte Liste von Schemanamen. Alle Felder aus diesen Schemas werden abgerufen. Sollte nur festgelegt werden, wenn „projection=custom“ gilt.
maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse.
orderBy

enum (OrderBy)

Spalte, die zum Sortieren der Ergebnisse verwendet werden soll
pageToken

string

Token zum Angeben der nächsten Seite in der Liste
projection

enum (Projection)

Welche Teilmenge von Feldern für diesen Nutzer abgerufen werden soll.
query

string

Suche nach Abfragestring. Enthält einen oder mehrere Suchbegriffe, die jeweils ein Feld, einen Operator und einen Wert enthalten. Die vollständige Dokumentation finden Sie unter Nach Nutzern suchen.
showDeleted

string

Wenn „true“ festgelegt ist, wird die Liste der gelöschten Nutzer abgerufen. (Standardeinstellung: false)
sortOrder

enum (SortOrder)

Gibt an, ob die Ergebnisse in aufsteigender oder absteigender Reihenfolge zurückgegeben werden sollen.
viewType

enum (ViewType)

Gibt an, ob die öffentliche Ansicht des Nutzers nur für Administratoren oder für die gesamte Domain abgerufen werden soll. Weitere Informationen finden Sie unter Nutzer als Nichtadministrator 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 Autorisierungsleitfaden.

EventType

Typ des Aboereignisses

Enums
ADD Vom Nutzer erstelltes Ereignis
DELETE Ereignis „Nutzer gelöscht“
MAKE_ADMIN Ereignis zur Änderung des Administratorstatus eines Nutzers
UNDELETE Ereignis „Nutzer wiederhergestellt“
UPDATE Ereignis „Nutzer aktualisiert“

OrderBy

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

Prognose

Enums
BASIC Nehmen Sie keine benutzerdefinierten Felder für den Nutzer auf.
CUSTOM Benutzerdefinierte Felder aus Schemas einschließen, die in „customFieldMask“ angegeben sind.
FULL Alle Felder, die mit diesem Nutzer verknüpft sind, einbeziehen.

SortOrder

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.

ViewType

Enums
admin_view Die Ergebnisse enthalten sowohl Felder, die nur für Administratoren sichtbar sind, als auch Felder, die für die gesamte Domain öffentlich sind.
domain_public Die Ergebnisse enthalten nur Felder für den Nutzer, die für andere Nutzer in der Domain öffentlich sichtbar sind.