Method: tasks.list

Gibt alle Aufgaben in der angegebenen Aufgabenliste zurück.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
tasklist

string

ID der Aufgabenliste.

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 Untergrenze 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 von Aufgabenlisten, die auf einer Seite zurückgegeben werden. Optional. Der Standardwert ist 20 (maximal zulässig: 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 auch „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

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

ETag der Ressource.

nextPageToken

string

Token für den Zugriff auf die nächste Seite dieses Ergebnisses.

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

ETag der Ressource.

nextPageToken

string

Token für den Zugriff auf die nächste Seite dieses Ergebnisses.

items[]

object (Task)

Sammlung von Aufgaben.