Tasks-Parameter verwenden
Neben den standardmäßigen Abfrageparametern, die mit den meisten Google APIs verwendet werden können, gibt es eine Reihe von Tasks-Parametern.
Anfrageparameter, die nur für bestimmte Vorgänge in der Google Tasks API gelten, sind in der folgenden Tabelle zusammengefasst. Alle Parameterwerte müssen URL-codiert sein.
Parameter |
Bedeutung |
Hinweise |
Geltungsbereich |
completedMax |
Obergrenze für das Abschlussdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. |
- Standardwert:
completedMax=2031-01-01
- Verwenden Sie das Zeitstempelformat RFC 3339. Beispiel:
2010-08-09T10:57:00.000-08:00
|
|
completedMin |
Untergrenze für das Abschlussdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. |
- Standardwert:
completedMin=1970-01-01
- Verwenden Sie das Zeitstempelformat RFC 3339. Beispiel:
2010-08-09T10:57:00.000-08:00
|
|
dueMax |
Obergrenze für das Fälligkeitsdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. |
- Standardwert:
dueMax=2031-01-01
- Verwenden Sie das Zeitstempelformat RFC 3339. Beispiel:
2010-08-09T10:57:00.000-08:00
|
|
dueMin |
Untergrenze für das Fälligkeitsdatum einer Aufgabe (als RFC 3339-Zeitstempel), nach der gefiltert werden soll. |
- Standardwert:
dueMin=1970-01-01
- Verwenden Sie das Zeitstempelformat RFC 3339. Beispiel:
2010-08-09T10:57:00.000-08:00
|
|
maxResults |
Die maximale Anzahl von Elementen, die mit dieser Anfrage zurückgegeben werden sollen. |
- Standardwert:
maxResults=20
- Maximal zulässiger Wert:
maxResults=100.
|
- Aufgabenlisten eines Nutzers abrufen
- Aufgaben abrufen
|
pageToken |
Token, das die zurückzugebende Ergebnisseite angibt. |
- Standardmäßig wird die erste Seite zurückgegeben.
|
- Aufgabenlisten eines Nutzers abrufen
- Aufgaben abrufen
|
parent |
Geben Sie die ID der übergeordneten Aufgabe an. |
- Kein Parameter gibt an, dass eine Aufgabe eingefügt oder auf die oberste Ebene der Aufgabenliste verschoben werden soll.
|
- Aufgabe erstellen
- Aufgabe anordnen
|
previous |
Geben Sie die vorherige Aufgaben-ID der Aufgabe an. |
- Kein Parameter gibt an, dass ein Eintrag oder eine Verschiebung an die erste Position in der Unterliste verschoben wurde.
|
- Aufgabe erstellen
- Aufgabe anordnen
|
showCompleted |
Geben Sie an, ob erledigte Aufgaben angezeigt werden sollen. |
- Standardwert:
showCompleted=true
|
|
showDeleted |
Geben Sie an, ob gelöschte Aufgaben angezeigt werden sollen. |
- Standardwert:
showDeleted=false
|
|
showHidden |
Legen Sie fest, ob ausgeblendete Aufgaben angezeigt werden sollen. |
- Standardwert:
showHidden=true
|
|
updatedMin |
Die Untergrenze für die letzte Änderungszeit einer Aufgabe (als RFC 3339-Zeitstempel) zum Filtern. |
- Verwenden Sie das Zeitstempelformat RFC 3339. Beispiel:
2010-08-09T10:57:00.000-08:00Z .
- Standardmäßig wird nicht nach dem Zeitpunkt der letzten Änderung gefiltert.
|
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-09-03 (UTC).
[null,null,["Zuletzt aktualisiert: 2024-09-03 (UTC)."],[[["In addition to standard query parameters, the Google Tasks API utilizes specific parameters for refined task management."],["These parameters control filtering by due dates, completion dates, modification times, and the visibility of completed, deleted, or hidden tasks."],["Developers can use these parameters to retrieve specific sets of tasks based on various criteria, such as completion status and due dates, using RFC 3339 timestamps for filtering."],["Parameters like `maxResults` and `pageToken` allow for pagination and control over the number of tasks returned in a response."],["The `parent` and `previous` parameters enable developers to manage task hierarchy and ordering within task lists."]]],["The Google Tasks API uses specific parameters for operations, all of which require URL encoding. These parameters filter tasks by `completedMin/Max`, `dueMin/Max`, and `updatedMin` date ranges using RFC 3339 timestamps. `maxResults` limits the number of returned items, and `pageToken` specifies the result page. `parent` and `previous` parameters determine task order, while `showCompleted`, `showDeleted`, and `showHidden` control the visibility of tasks. These parameters apply to retrieving tasks and task lists, creating, and ordering tasks.\n"]]