Method: alerts.list

Enumera las alertas.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
customerId

string

Opcional. Es el identificador único de la cuenta de Google Workspace del cliente con el que están asociadas las alertas. Se debe quitar la “C” inicial de customerId (por ejemplo, 046psxkn). Se deduce de la identidad del emisor si no se proporciona. Cómo encontrar tu ID de cliente
pageSize

integer

Opcional. Es el tamaño de la página solicitado. Es posible que el servidor muestre menos elementos de los solicitados. Si no se especifica, el servidor elige una configuración predeterminada adecuada.
pageToken

string

Opcional. Un token que identifica una página de resultados que el servidor debe mostrar. Si está vacío, se inicia una iteración nueva. Para continuar una iteración, pasa el valor del campo nextPageToken de la ListListsResponse anterior.
filter

string

Opcional. Una cadena de consulta para filtrar los resultados de alertas. Para obtener más información, consulte Filtros de consulta y Campos de filtro de consulta admitidos.
orderBy

string

Opcional. El orden de los resultados de la lista. Si no se especifica, se pueden mostrar resultados en orden arbitrario. Puedes ordenar los resultados en orden descendente según la marca de tiempo de creación mediante orderBy="createTime desc". Actualmente, se permiten las clasificaciones createTime asc, createTime desc y updateTime desc

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Mensaje de respuesta para una solicitud de listado de alertas.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
Campos
alerts[]

object (Alert)

La lista de alertas.
nextPageToken

string

El token de la página siguiente. Si no está vacío, indica que puede haber más alertas que coincidan con la solicitud de ficha. Este valor se puede usar en un ListAlertsRequest posterior para obtener alertas que continúen desde el último resultado de la llamada de lista actual.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la Guía de autorización.