- Solicitud HTTP
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
Muestra una lista de las tareas que coinciden con el filtro especificado.
Solicitud HTTP
GET https://ces.googleapis.com/tasks
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
| Parámetros | |
|---|---|
tenant |
Es opcional. Es un identificador de enrutamiento opaco. Debe coincidir con el valor |
contextId |
Filtra las tareas por ID de contexto para obtener tareas de una conversación o sesión específica. |
status |
Filtra las tareas por su estado actual. |
pageToken |
Un token de página, recibido desde una llamada |
statusTimestampAfter |
Filtra las tareas que tienen un estado actualizado después de la marca de tiempo proporcionada en formato ISO 8601 (p.ej., "2023-10-27T10:00:00Z"). Solo se mostrarán las tareas con una marca de tiempo de estado mayor o igual que este valor. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: |
pageSize |
La cantidad máxima de tareas que se devolverán. El servicio puede mostrar menos que este valor. Si no se especifica, se devolverán, como máximo, 50 tareas. El valor mínimo es 1. El valor máximo es 100. |
historyLength |
La cantidad máxima de mensajes que se incluirán en el historial de cada tarea. |
includeArtifacts |
Indica si se deben incluir artefactos en las tareas que se muestran. El valor predeterminado es false para reducir el tamaño de la carga útil. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Objeto de resultado para el método tasks.list que contiene un array de tareas y la información de paginación.
Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:
| Representación JSON |
|---|
{
"tasks": [
{
object ( |
| Campos | |
|---|---|
tasks[] |
Obligatorio. Es un array de tareas que coinciden con los criterios especificados. |
nextPageToken |
Obligatorio. Es un token para recuperar la siguiente página de resultados o está vacío si no hay más resultados en la lista. |
pageSize |
Obligatorio. Es el tamaño de página que se usa para esta respuesta. |
totalSize |
Obligatorio. Es la cantidad total de tareas disponibles (antes de la paginación). |
Permisos de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/cloud-platformhttps://www.googleapis.com/auth/ces
Para obtener más información, consulta Authentication Overview.