Method: tasks.list

Gibt alle Aufgaben in der angegebenen Aufgabenliste zurück Ein Nutzer kann pro Liste bis zu 20.000 nicht erledigte Aufgaben und insgesamt bis zu 100.000 Aufgaben gleichzeitig haben.

HTTP-Anfrage

GET https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
tasklist

string

Aufgabenlisten-ID.

Abfrageparameter

Parameter
completedMax

string

Obergrenze für das Abschlussdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. Optional. Standardmäßig wird nicht nach Abschlussdatum gefiltert.

completedMin

string

Die untere Grenze für das Abschlussdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. Optional. Standardmäßig wird nicht nach Abschlussdatum gefiltert.

dueMax

string

Obergrenze für das Fälligkeitsdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach dem gefiltert werden soll. Optional. Standardmäßig wird nicht nach Fälligkeitsdatum gefiltert.

dueMin

string

Die Untergrenze für das Fälligkeitsdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. Optional. Standardmäßig wird nicht nach Fälligkeitsdatum gefiltert.

maxResults

integer

Maximale Anzahl der Aufgaben, die auf einer Seite zurückgegeben werden. Optional. Der Standardwert ist 20 (max. 100).

pageToken

string

Token, das die zurückzugebende Ergebnisseite angibt. Optional.

showCompleted

boolean

Flag, das angibt, ob abgeschlossene Aufgaben im Ergebnis zurückgegeben werden. Optional. Der Standardwert ist „True“. Für „showHidden“ muss außerdem „True“ festgelegt sein, damit Aufgaben angezeigt werden, die in eigenen Clients wie der Web-UI und den mobilen Apps von Google erledigt wurden.

showDeleted

boolean

Flag, das angibt, ob gelöschte Aufgaben im Ergebnis zurückgegeben werden. Optional. Die Standardeinstellung ist "False".

showHidden

boolean

Flag, das angibt, ob im Ergebnis ausgeblendete Aufgaben zurückgegeben werden. Optional. Die Standardeinstellung ist "False".

updatedMin

string

Die Untergrenze für den Zeitpunkt der letzten Änderung einer Aufgabe (als RFC 3339-Zeitstempel), nach dem gefiltert werden soll. Optional. Standardmäßig wird nicht nach dem Zeitpunkt der letzten Änderung gefiltert.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Felder
kind

string

Typ der Ressource. Dies ist immer „tasks#tasks“.

etag

string

Das ETag der Ressource.

nextPageToken

string

Token, das für den Zugriff auf die nächste Seite dieses Ergebnisses verwendet wird.

items[]

object (Task)

Sammlung von Aufgaben.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/tasks
  • https://www.googleapis.com/auth/tasks.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

Aufgaben

JSON-Darstellung
{
  "kind": string,
  "etag": string,
  "nextPageToken": string,
  "items": [
    {
      object (Task)
    }
  ]
}
Felder
kind

string

Typ der Ressource. Dies ist immer „tasks#tasks“.

etag

string

Das ETag der Ressource.

nextPageToken

string

Token, das für den Zugriff auf die nächste Seite dieses Ergebnisses verwendet wird.

items[]

object (Task)

Sammlung von Aufgaben.