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. Il valore customerId deve essere privato dell'iniziale "C" (ad esempio 046psxkn). Se non viene fornito, viene dedotto dall'identità dell'utente che chiama. Trova il tuo ID cliente.
pageSize

integer

Facoltativo. Le dimensioni della pagina richieste. Il server potrebbe restituire meno elementi rispetto a quelli richiesti. Se non viene 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 dell'oggetto ListAlertsResponse precedente.
filter

string

Facoltativo. Una stringa di query per filtrare i risultati degli avvisi. Per maggiori dettagli, consulta Filtri delle query e Campi dei filtri delle query supportati.
orderBy

string

Facoltativo. L'ordine di ordinamento dei risultati dell'elenco. Se non specificato, i risultati potrebbero essere restituiti in ordine arbitrario. Puoi ordinare i risultati in ordine decrescente in base al timestamp di creazione utilizzando orderBy="createTime desc". Al momento, gli ordini supportati sono createTime asc, createTime desc, updateTime desc

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per una richiesta di elenco di avvisi.

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 è vuoto, indica che potrebbero esserci altri avvisi corrispondenti alla richiesta di scheda. Questo valore può essere utilizzato in un ListAlertsRequest successivo per ricevere avvisi che continuano dall'ultimo risultato della chiamata all'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.