REST Resource: tasks

Ressource: Aufgabe

JSON-Darstellung
{
  "kind": string,
  "id": string,
  "etag": string,
  "title": string,
  "updated": string,
  "selfLink": string,
  "parent": string,
  "position": string,
  "notes": string,
  "status": string,
  "due": string,
  "completed": string,
  "deleted": boolean,
  "hidden": boolean,
  "links": [
    {
      "type": string,
      "description": string,
      "link": string
    }
  ],
  "webViewLink": string
}
Felder
kind

string

Nur Ausgabe. Typ der Ressource. Dies ist immer „tasks#task“.

id

string

Aufgaben-ID.

etag

string

Das ETag der Ressource.

title

string

Titel der Aufgabe. Maximal zulässige Länge: 1.024 Zeichen.

updated

string

Nur Ausgabe. Zeitpunkt der letzten Änderung der Aufgabe (als RFC 3339-Zeitstempel).

parent

string

Nur Ausgabe. Kennung der übergeordneten Aufgabe. Dieses Feld wird weggelassen, wenn es sich um eine übergeordnete Aufgabe handelt. Dieses Feld ist schreibgeschützt. Verschieben Sie die Aufgabe mithilfe der Methode „move“ unter ein anderes übergeordnetes Element oder auf die oberste Ebene.

position

string

Nur Ausgabe. String, der die Position der Aufgabe unter ihren gleichgeordneten Aufgaben in derselben übergeordneten Aufgabe oder auf der obersten Ebene angibt. Ist dieser String entsprechend der lexikografischen Reihenfolge größer als der entsprechende Positionsstring einer anderen Aufgabe, wird die Aufgabe nach der anderen Aufgabe unter derselben übergeordneten Aufgabe (oder auf der obersten Ebene) platziert. Verwenden Sie die Methode „move“, um die Aufgabe an eine andere Position zu verschieben.

notes

string

Notizen, die die Aufgabe beschreiben. Optional. Maximal zulässige Länge: 8.192 Zeichen.

status

string

Status der Aufgabe. Dies ist entweder „needsAction“ oder „completed“.

due

string

Fälligkeitsdatum der Aufgabe (als RFC 3339-Zeitstempel). Optional. Beim Fälligkeitsdatum werden nur Informationen zum Datum erfasst. Die Uhrzeit des Zeitstempels wird beim Festlegen des Fälligkeitsdatums verworfen. Die Zeit, zu der eine Aufgabe fällig ist, kann nicht über die API gelesen oder geschrieben werden.

completed

string

Abschlussdatum der Aufgabe (als RFC 3339-Zeitstempel). Dieses Feld wird weggelassen, wenn die Aufgabe noch nicht abgeschlossen wurde.

deleted

boolean

Flag, das angibt, ob die Aufgabe gelöscht wurde. Die Standardeinstellung ist "False".

hidden

boolean

Flag, das angibt, ob die Aufgabe ausgeblendet ist. Dies ist der Fall, wenn die Aufgabe beim letzten Löschen der Aufgabenliste als erledigt markiert wurde. Die Standardeinstellung ist "False". Dieses Feld ist schreibgeschützt.

links[].type

string

Linktyp, z.B. „E-Mail“.

links[].description

string

Die Beschreibung. In HTML sprechen wir: alles zwischen <a> und </a>.

links[].link

string

Die URL.

Methoden

clear

Löscht alle erledigten Aufgaben aus der angegebenen Aufgabenliste.

delete

Löscht die angegebene Aufgabe aus der Aufgabenliste.

get

Gibt die angegebene Aufgabe zurück.

insert

Erstellt eine neue Aufgabe in der angegebenen Aufgabenliste.

list

Gibt alle Aufgaben in der angegebenen Aufgabenliste zurück.

move

Verschiebt die angegebene Aufgabe an eine andere Position in der Aufgabenliste.

patch

Aktualisiert die angegebene Aufgabe.

update

Aktualisiert die angegebene Aufgabe.