Method: tasks.list

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

ID der Aufgabenliste.

Abfrageparameter

Parameter
completedMax

string

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

completedMin

string

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

dueMax

string

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

dueMin

string

Untere Grenze für den Abgabetermin einer Aufgabe (als RFC 3339-Zeitstempel), nach dem gefiltert werden soll. Optional. Standardmäßig wird nicht nach Abgabetermin gefiltert.

maxResults

integer

Die maximale Anzahl von Aufgaben, 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

Gibt an, ob erledigte Aufgaben im Ergebnis zurückgegeben werden. Hinweis: „showHidden“ muss auch „wahr“ sein, damit in eigenen Clients abgeschlossene Aufgaben angezeigt werden, z. B. in der Web-UI und in den mobilen Apps von Google. Optional. Der Standardwert ist „True“.

showDeleted

boolean

Gibt an, ob gelöschte Aufgaben im Ergebnis zurückgegeben werden. Optional. Die Standardeinstellung ist "False".

showHidden

boolean

Gibt an, ob ausgeblendete Aufgaben im Ergebnis zurückgegeben werden. Optional. Die Standardeinstellung ist "False".

updatedMin

string

Untere Grenze für die Uhrzeit der letzten Änderung einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. Optional. Standardmäßig wird nicht nach der Uhrzeit der letzten Änderung gefiltert.

showAssigned

boolean

Optional. Gibt an, 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

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

etag

string

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

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

etag

string

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.