Method: users.watch

Wartet 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, um nur Nutzer aus dieser Domain abzurufen. Wenn stattdessen alle Nutzer in einem Kundenfeld mit mehreren Domains zurückgegeben werden sollen.“

customer

string

Unveränderliche ID des Google Workspace-Kontos. Wenn Sie mehrere Domains haben, füllen Sie dieses Feld anstelle der 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. Dieser Parameter sollte nur festgelegt werden, wenn projection=custom.

maxResults

integer

Maximale Anzahl der zurückzugebenden Ergebnisse;

orderBy

enum (OrderBy)

Spalte, die zum Sortieren der Ergebnisse verwendet werden soll

pageToken

string

Token zur Angabe der nächsten Seite in der Liste

projection

enum (Projection)

Teilmenge von Feldern, die für diesen Nutzer abgerufen werden sollen.

query

string

Suche nach Abfragestring. Muss im Format „“ vorliegen. Die vollständige Dokumentation finden Sie unter https: //developers.google.com/admin-sdk/directory/v1/guides/search-users

showDeleted

string

Wenn dieser Wert auf „true“ gesetzt ist, 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 nur für Administratoren oder die domainweite öffentliche Ansicht des Nutzers abgerufen werden soll. Weitere Informationen finden Sie unter 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 Vom Nutzer gelöschter Termin
MAKE_ADMIN Nutzeradministrator-Statusänderungsereignis
UNDELETE Nutzerereignis wiederhergestellt
UPDATE Durch Nutzer aktualisiertes Ereignis

OrderBy

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

Projektion

Enums
BASIC Geben Sie keine benutzerdefinierten Felder für den Nutzer an.
CUSTOM Benutzerdefinierte Felder aus Schemas einschließen, die in „customFieldMask“ erwähnt werden.
FULL Alle mit diesem Nutzer verknüpften Felder einschließen.

SortOrder

Enums
ASCENDING Aufsteigende Reihenfolge.
DESCENDING Absteigende Reihenfolge.

ViewType

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