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
    }
  ],
  "webViewLink": string
}
Felder
kind

string

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

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

parent

string

ID der übergeordneten Aufgabe. 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 eine andere übergeordnete Ebene 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. Wenn dieser String größer als der entsprechende Positionsstring einer anderen Aufgabe gemäß lexikografischer Reihenfolge ist, wird die Aufgabe hinter der anderen Aufgabe unter derselben übergeordneten Aufgabe (oder auf der obersten Ebene) 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. Maximal zulässige Länge: 8.192 Zeichen.

status

string

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

due

string

Das Fälligkeitsdatum der Aufgabe (als RFC 3339-Zeitstempel). Optional. Beim Fälligkeitsdatum werden nur Datumsinformationen erfasst. Der Zeitabschnitt des Zeitstempels wird beim Festlegen des Fälligkeitsdatums verworfen. Es ist nicht möglich, die Zeit, zu der eine Aufgabe fällig ist, über die API zu lesen oder zu schreiben.

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 war. Die Standardeinstellung ist "False". Dieses Feld ist schreibgeschützt.

links[].type

string

Linktyp, z. B. "E-Mail"

links[].description

string

Die Beschreibung In HTML-Spracheingabe: 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 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.