REST Resource: tasks

Ressource: Task

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
    }
  ]
}
Felder
kind

string

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

id

string

Aufgaben-ID.

etag

string

ETag der Ressource.

title

string

Titel der Aufgabe.

updated

string

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

parent

string

Übergeordnete Aufgaben-ID. Dieses Feld wird weggelassen, wenn es sich um eine Aufgabe der obersten Ebene handelt. Dieses Feld ist schreibgeschützt. Verwenden Sie die Methode „move“, um die Aufgabe unter ein anderes übergeordnetes Element oder auf die oberste Ebene zu verschieben.

position

string

String, der die Position der Aufgabe unter den gleichgeordneten Aufgaben unter derselben übergeordneten Aufgabe oder auf der obersten Ebene angibt. Ist dieser String gemäß lexikografischer Reihenfolge größer als der entsprechende Positionsstring einer anderen Aufgabe, wird die Aufgabe unter derselben übergeordneten Aufgabe (oder auf oberster Ebene) hinter der anderen Aufgabe platziert. Dieses Feld ist schreibgeschützt. Verwenden Sie die Methode „move“, um die Aufgabe an eine andere Position zu verschieben.

notes

string

Notizen zur Beschreibung der Aufgabe. Optional.

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 Datumsinformationen erfasst. Die Uhrzeitangabe des Zeitstempels wird beim Festlegen des Fälligkeitsdatums verworfen. Es ist nicht möglich, die Zeit zu lesen oder zu schreiben, zu der eine Aufgabe über die API ansteht.

completed

string

Abschlussdatum der Aufgabe (als RFC 3339-Zeitstempel). Dieses Feld wird weggelassen, wenn die Aufgabe 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 als erledigt markiert wurde, als die Aufgabenliste das letzte Mal gelöscht wurde. Die Standardeinstellung ist "False". Dieses Feld ist schreibgeschützt.

links[].type

string

Art des Links, z.B. "E-Mail".

links[].description

string

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

links[].link

string

Die URL.

Methoden

clear

Löscht alle abgeschlossenen Aufgaben aus der angegebenen Aufgabenliste.

delete

Löscht die angegebene Aufgabe aus der Aufgabenliste.

get

Gibt die angegebene Task 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.