Method: alerts.list

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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. El identificador único de la cuenta de Google Workspace del cliente con el que están asociadas las alertas. customerId debe tener la "C" inicial seccionada (por ejemplo, 046psxkn). Inferida de la identidad del emisor si no se proporciona. Busca tu ID de cliente.

pageSize

integer

Opcional. El tamaño de página solicitado. Es posible que el servidor muestre menos artículos 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ía, se inicia una iteración nueva. Para continuar una iteración, pasa el valor del campo nextPageToken de ListAlertsResponse anterior.

filter

string

Opcional. Una cadena de consulta para filtrar los resultados de la alerta. Para obtener más detalles, consulta Filtros de consulta y Campos de filtro de consulta admitidos.

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 de forma descendente según la marca de tiempo de creación mediante orderBy="createTime desc". Actualmente, se admiten 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

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

Mensaje de respuesta a una solicitud de ficha de alerta.

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.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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