Method: tasks.list

Listet Aufgaben auf, die dem angegebenen Filter entsprechen.

HTTP-Anfrage

GET https://ces.googleapis.com/tasks

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
tenant

string

Optional. Intransparente Routing-ID. Muss mit dem tenant-Wert des ausgewählten AgentInterface auf der Agent-Karte übereinstimmen, wenn dieses Feld festgelegt ist.
contextId

string

Filtern Sie Aufgaben nach Kontext-ID, um Aufgaben aus einer bestimmten Unterhaltung oder Sitzung abzurufen.
status

enum (TaskState)

Aufgaben nach ihrem aktuellen Status filtern
pageToken

string

Ein Seitentoken, das von einem vorherigen tasks.list-Aufruf empfangen wurde. ListTasksResponse.next_page_token. Geben Sie dieses an, um die nachfolgende Seite abzurufen.
statusTimestampAfter

string (Timestamp format)

Filtert Aufgaben, deren Status nach dem angegebenen Zeitstempel im ISO 8601-Format aktualisiert wurde (z.B. „2023-10-27T10:00:00Z“). Es werden nur Aufgaben mit einem Status-Zeitstempel zurückgegeben, der größer oder gleich diesem Wert ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
pageSize

integer

Die maximale Anzahl der zurückzugebenden Aufgaben. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Falls nicht angegeben, werden maximal 50 Aufgaben zurückgegeben. Der Mindestwert beträgt 1. Der Höchstwert ist 100.
historyLength

integer

Die maximale Anzahl von Nachrichten, die im Verlauf jeder Aufgabe enthalten sein sollen.
includeArtifacts

boolean

Gibt an, ob Artefakte in die zurückgegebenen Aufgaben einbezogen werden sollen. Die Standardeinstellung ist „false“, um die Nutzlastgröße zu verringern.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Ergebnisobjekt für die tasks.list-Methode, das ein Array von Aufgaben und Paginierungsinformationen enthält.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "tasks": [
    {
      object (Task)
    }
  ],
  "nextPageToken": string,
  "pageSize": integer,
  "totalSize": integer
}
Felder
tasks[]

object (Task)

Erforderlich. Array von Aufgaben, die den angegebenen Kriterien entsprechen.
nextPageToken

string

Erforderlich. Ein Token zum Abrufen der nächsten Ergebnisseite. Leer, wenn keine weiteren Ergebnisse in der Liste vorhanden sind.
pageSize

integer

Erforderlich. Die für diese Antwort verwendete Seitengröße.
totalSize

integer

Erforderlich. Gesamtzahl der verfügbaren Aufgaben (vor der Paginierung).

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Weitere Informationen finden Sie unter Authentication Overview.