- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Aufgaben
- Testen!
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 |
ID der Aufgabenliste. |
Abfrageparameter
Parameter | |
---|---|
completedMax |
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 |
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 |
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 |
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 |
Maximale Anzahl der auf einer Seite zurückgegebenen Aufgaben. Optional. Der Standardwert ist 20 (maximal zulässig: 100). |
pageToken |
Token, das die Ergebnisseite angibt, die zurückgegeben werden soll. Optional. |
showCompleted |
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 |
Flag, das angibt, ob gelöschte Aufgaben im Ergebnis zurückgegeben werden. Optional. Die Standardeinstellung ist "False". |
updatedMin |
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 |
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 ( |
Felder | |
---|---|
kind |
Typ der Ressource. Dies ist immer „tasks#tasks“. |
etag |
Das ETag der Ressource. |
nextPageToken |
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 |
Typ der Ressource. Dies ist immer „tasks#tasks“. |
etag |
Das ETag der Ressource. |
nextPageToken |
Token, das für den Zugriff auf die nächste Seite dieses Ergebnisses verwendet wird. |
items[] |
Sammlung von Aufgaben. |