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 se asocian las alertas. customerId debe tener la “C” inicial (por ejemplo, 046psxkn). Se infiere de la identidad del emisor si no se proporciona. Cómo encontrar tu ID de cliente
pageSize

integer

Opcional. 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 un valor predeterminado adecuado.
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 con una iteración, pasa el valor del campo nextPageToken de ListAlertsResponse anterior.
filter

string

Opcional. Una cadena de consulta para filtrar los resultados de alertas. Para obtener más detalles, consulta Filtros de consulta y Campos de filtros de consulta compatibles.
orderBy

string

Opcional. El orden de clasificación de los resultados de la lista. Si no se especifican, los resultados se pueden mostrar en un orden arbitrario. Puedes ordenar los resultados en orden descendente según la marca de tiempo de creación mediante orderBy="createTime desc". Actualmente, se admiten los ordenamientos 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

El token para 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 a lista actual.

Alcances 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.