Method: alerts.list

Elenca gli avvisi.

Richiesta HTTP

GET https://alertcenter.googleapis.com/v1beta1/alerts

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
customerId

string

(Facoltativo) L'identificatore univoco dell'account Google Workspace del cliente a cui sono associati gli avvisi. customerId deve avere la lettera "C" iniziale (ad esempio, 046psxkn). Deduzione dall'identità del chiamante, se non fornita. Individua l'ID cliente.
pageSize

integer

(Facoltativo) Le dimensioni di pagina richieste. Il server potrebbe restituire meno elementi di quelli richiesti. Se non specificato, il server sceglie un valore predefinito appropriato.
pageToken

string

(Facoltativo) Un token che identifica una pagina di risultati che il server deve restituire. Se vuoto, viene avviata una nuova iterazione. Per continuare un'iterazione, passa il valore del campo nextPageToken precedente di ListAlertsResponse.
filter

string

(Facoltativo) Una stringa di query per filtrare i risultati degli avvisi. Per maggiori dettagli, consulta Filtri di query e Campi filtro di query supportati.
orderBy

string

(Facoltativo) L'ordinamento dei risultati dell'elenco. Se non viene specificato, i risultati possono essere restituiti in ordine arbitrario. Puoi ordinare i risultati in ordine decrescente in base al timestamp di creazione utilizzando orderBy="createTime desc". Al momento, l'ordinamento supportato è createTime asc, createTime desc e updateTime desc

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per una richiesta di elenco di un avviso.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
Campi
alerts[]

object (Alert)

L'elenco degli avvisi.
nextPageToken

string

Il token per la pagina successiva. Se non viene lasciato vuoto, indica che potrebbero esserci altri avvisi corrispondenti alla richiesta di scheda. questo valore può essere utilizzato in un ListAlertsRequest successivo per ricevere avvisi dall'ultimo risultato della chiamata dell'elenco corrente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/apps.alerts

Per ulteriori informazioni, consulta la Guida all'autorizzazione.