Method: users.watch

Guarda 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 ricerca

Parametri
domain

string

Nome del dominio. Compila questo campo per consentire agli utenti solo da questo dominio. Per restituire tutti gli utenti inseriti in un campo di riempimento clienti a più domini."

customer

string

ID immutabile dell'account Google Workspace. Nel 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 schema. Tutti i campi di questi schemi vengono recuperati. Deve essere impostato solo quando proiezione=custom.

maxResults

integer

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)

Quale sottoinsieme di campi è stato recuperato da questo utente.

query

string

Ricerca stringa di query. Deve essere "". La documentazione completa è disponibile all'indirizzo https:developers.google.com/admin-sdk/directory/v1/guides/search-users

showDeleted

string

Se è impostata su true, recupera l'elenco degli utenti eliminati. (Valore predefinito: false)

sortOrder

enum (SortOrder)

Indica se i risultati vengono visualizzati in ordine crescente o decrescente.

viewType

enum (ViewType)

Indica se recuperare la visualizzazione pubblica a livello di amministratore o di dominio dell'utente. Per saperne di più, vedi Recuperare un utente come 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 alle autorizzazioni.

EventType

Tipo di evento di iscrizione

Enum
ADD Evento creato dall'utente
DELETE Evento eliminato dall'utente
MAKE_ADMIN Evento modifica stato amministratore utente
UNDELETE Evento non eliminato utente
UPDATE Evento aggiornato utente

OrderBy

Enum
EMAIL L'indirizzo email principale dell'utente.
FAMILY_NAME Cognome dell'utente.
GIVEN_NAME Nome dell'utente.

Proiezione

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

SortOrder

Enum
ASCENDING Ordine crescente.
DESCENDING Ordine decrescente.

Tipo di visualizzazione

Enum
admin_view I risultati includono sia i campi riservati all'amministratore sia i campi pubblici.
domain_public I risultati includono solo i campi relativi all'utente visibili pubblicamente ad altri utenti del dominio.