Method: tasks.list

Gibt alle Aufgaben in der angegebenen Aufgabenliste zurück. Zugewiesene Aufgaben (aus Google Docs, Chatbereichen) werden nicht als Standard zurückgegeben. Ein Nutzer kann bis zu 20.000 nicht ausgeblendete Aufgaben pro Liste 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

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

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 der gefiltert werden soll. Optional. Standardmäßig wird nicht nach Fälligkeitsdatum gefiltert.
dueMin

string

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 auf einer Seite zurückgegebenen Aufgaben. Optional. Der Standardwert ist 20 (maximal zulässig: 100).
pageToken

string

Token, das die Ergebnisseite angibt, die zurückgegeben werden soll. Optional.
showCompleted

boolean

Flag, das angibt, ob abgeschlossene Aufgaben im Ergebnis zurückgegeben werden. Für „showHidden“ muss auch „True“ festgelegt sein, damit Aufgaben angezeigt werden, die in Erstanbieter-Clients erledigt wurden, z. B. in der Web-UI und in den mobilen Apps von Google. Optional. Der Standardwert ist „True“.
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 die letzte Änderungszeit einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. Optional. Standardmäßig wird nicht nach dem Zeitpunkt der letzten Änderung gefiltert.
showAssigned

boolean

Optional. Flag, das angibt, ob Aufgaben, die dem aktuellen Nutzer zugewiesen sind, im Ergebnis zurückgegeben werden. Optional. Die Standardeinstellung ist "False".

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.