- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Tasks
- Testen!
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 |
ID der Aufgabenliste. |
Abfrageparameter
Parameter | |
---|---|
completed |
Obergrenze für das Fertigstellungsdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach dem gefiltert werden soll. Optional. Standardmäßig wird nicht nach Abschlussdatum gefiltert. |
completed |
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. |
due |
Obergrenze für den Abgabetermin einer Aufgabe (als RFC 3339-Zeitstempel), nach dem gefiltert werden soll. Optional. Standardmäßig wird nicht nach Abgabetermin gefiltert. |
due |
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. |
max |
Die maximale Anzahl von Aufgaben, die auf einer Seite zurückgegeben werden. Optional. Der Standardwert ist 20 (maximal zulässig: 100). |
page |
Token, das die zurückzugebende Ergebnisseite angibt. Optional. |
show |
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“. |
show |
Gibt an, ob gelöschte Aufgaben im Ergebnis zurückgegeben werden. Optional. Die Standardeinstellung ist "False". |
updated |
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. |
show |
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 ( |
Felder | |
---|---|
kind |
Der Typ der Ressource. Dies ist immer „tasks#tasks“. |
etag |
ETag der Ressource. |
next |
Token, das für den Zugriff auf die nächste Seite dieses Ergebnisses verwendet wird. |
items[] |
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 ( |
Felder | |
---|---|
kind |
Der Typ der Ressource. Dies ist immer „tasks#tasks“. |
etag |
ETag der Ressource. |
next |
Token, das für den Zugriff auf die nächste Seite dieses Ergebnisses verwendet wird. |
items[] |
Sammlung von Aufgaben. |