Method: users.watch

Controlla le modifiche nell'elenco degli utenti.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
domain

string

Nome del dominio. Compila questo campo per ottenere gli utenti solo da questo dominio. Per restituire tutti gli utenti in un campo cliente multidominio, compila il campo cliente."
customer

string

ID immutabile dell'account Google Workspace. In caso di più domini, per recuperare tutti gli utenti di un cliente, compila questo campo anziché il dominio.
event

enum (EventType)

Eventi a cui prestare attenzione.
customFieldMask

string

Elenco separato da virgole di nomi di schemi. Vengono recuperati tutti i campi di questi schemi. Questo valore deve essere impostato solo quando projection=custom.
maxResults

integer

Il numero massimo di risultati da restituire.
orderBy

enum (OrderBy)

Colonna da utilizzare per ordinare i risultati
pageToken

string

Token per specificare la pagina successiva nell'elenco
projection

enum (Projection)

Il sottoinsieme di campi da recuperare per questo utente.
query

string

Ricerca nella stringa di query. Deve avere il formato "". La documentazione completa è disponibile all'indirizzo https: //developers.google.com/workspace/admin/directory/v1/guides/search-users
showDeleted

string

Se impostato su true, recupera l'elenco degli utenti eliminati. (valore predefinito: false)
sortOrder

enum (SortOrder)

Indica se i risultati devono essere restituiti in ordine crescente o decrescente.
viewType

enum (ViewType)

Indica se recuperare la visualizzazione pubblica solo per gli amministratori o a livello di dominio dell'utente. Per saperne di più, vedi Recuperare un utente come utente non amministratore.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di SubscriptionChannel.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di SubscriptionChannel.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Guida all'autorizzazione.

EventType

Tipo di evento Subscription

Enum
ADD Evento creato dall'utente
DELETE Evento utente eliminato
MAKE_ADMIN Evento di modifica dello stato amministratore utente
UNDELETE Evento di annullamento dell'eliminazione dell'utente
UPDATE Evento di aggiornamento utente

OrderBy

Enum
EMAIL Indirizzo email principale dell'utente.
FAMILY_NAME Il cognome dell'utente.
GIVEN_NAME Nome dell'utente.

Projection

Enum
BASIC Non includere campi personalizzati per l'utente.
CUSTOM Includi i campi personalizzati dagli schemi menzionati in customFieldMask.
FULL Includi tutti i campi associati a questo utente.

SortOrder

Enum
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.

ViewType

Enum
admin_view I risultati includono sia i campi riservati agli amministratori sia quelli pubblici del dominio.
domain_public I risultati includono solo i campi per l'utente che sono visibili pubblicamente agli altri utenti del dominio.