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 ricerca

Parametri
customerId

string

Campo facoltativo. L'identificatore univoco dell'account Google Workspace del cliente a cui sono associati gli avvisi. customerId deve rimuovere il valore "C" iniziale (ad es. 046psxkn). È stato dedotto dall'identità del chiamante, se non viene fornito. Trova il tuo ID cliente.

pageSize

integer

Campo facoltativo. Le dimensioni della pagina richieste. Il server potrebbe restituire meno articoli del previsto. Se il valore non è specificato, il server sceglie un'impostazione predefinita appropriata.

pageToken

string

Campo facoltativo. Un token che identifica una pagina di risultati che il server dovrebbe restituire. Se vuoto, viene avviata una nuova iterazione. Per continuare, ripeti il valore del campo nextPageToken dell'elenco ListAlertsResponse precedente.

filter

string

Campo facoltativo. Una stringa di query per filtrare i risultati degli avvisi. Per ulteriori dettagli, consulta Filtri di query e Campi supportati per il filtro di query.

orderBy

string

Campo facoltativo. L'ordinamento dei risultati dell'elenco. Se non vengono specificati, 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". Attualmente l'ordinamento supportato è 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 degli 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 della pagina successiva. Se non è vuota, indica che potrebbero esserci altri avvisi che corrispondono alla richiesta di elenco; questo valore può essere utilizzato in un ListAlertsRequest successivo per ricevere avvisi dall'ultimo risultato della chiamata di elenco corrente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Guida alle autorizzazioni.