Method: alerts.list

Muestra una lista de 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. El customerId debe quitar la inicial "C" (por ejemplo, 046psxkn). Se infiere de la identidad del emisor si no se proporciona. Encuentra tu ID de cliente.
pageSize

integer

Opcional. Es el tamaño de página solicitado. Es posible que el servidor devuelva 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 debe mostrar el servidor. Si está vacío, se inicia una nueva iteración. Para continuar con una iteración, pasa el valor del campo nextPageToken de la ListAlertsResponse anterior.
filter

string

Opcional. Es una cadena de consulta para filtrar los resultados de las alertas. Para obtener más detalles, consulta Filtros de consulta y Campos de filtro de consulta admitidos.
orderBy

string

Opcional. Es el orden de clasificación de los resultados de la lista. Si no se especifica, los resultados pueden mostrarse en un orden arbitrario. Puedes ordenar los resultados en orden descendente según la marca de tiempo de creación con orderBy="createTime desc". Actualmente, los ordenes admitidos son 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 ficha de alerta.

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

Es 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 una ListAlertsRequest posterior para obtener alertas que continúen desde el último resultado de la llamada a la 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.