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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
Felder
kind

string

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

string

Aufgaben-ID.
etag

string

ETag der Ressource.
title

string

Titel der Aufgabe. Maximale Länge: 1.024 Zeichen.
updated

string

Nur Ausgabe. Letzte Änderungszeit der Aufgabe (als RFC 3339-Zeitstempel).
parent

string

Nur Ausgabe. ID der übergeordneten Aufgabe. Dieses Feld wird weggelassen, wenn es sich um eine Aufgabe auf oberster Ebene handelt. Verwenden Sie die Methode „move“, um die Aufgabe unter ein anderes übergeordnetes Element oder in die oberste Ebene zu verschieben. Eine übergeordnete Aufgabe kann niemals eine zugewiesene Aufgabe sein (aus Chatbereichen, Docs). Dieses Feld ist schreibgeschützt.
position

string

Nur Ausgabe. String, der die Position der Aufgabe unter den übergeordneten Aufgaben oder auf der obersten Ebene angibt. Wenn dieser String gemäß der lexikografischen Reihenfolge größer als der entsprechende Positionierungsstring einer anderen Aufgabe ist, 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 zur Beschreibung der Aufgabe. Aufgaben, die über Google Docs zugewiesen werden, können keine Notizen enthalten. Optional. Maximale Länge: 8.192 Zeichen.
status

string

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

string

Abgabetermin der Aufgabe (als RFC 3339-Zeitstempel). Optional. Für den Termin werden nur Datumsangaben erfasst. Der Zeitanteil des Zeitstempels wird beim Festlegen des Termins verworfen. Es ist nicht möglich, den Termin für eine Aufgabe über die API zu lesen oder zu schreiben.
completed

string

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

boolean

Gibt an, ob die Aufgabe gelöscht wurde. Bei zugewiesenen Aufgaben ist dieses Feld schreibgeschützt. Sie können nur durch Aufrufen von tasks.delete gelöscht werden. In diesem Fall werden sowohl die zugewiesene Aufgabe als auch die ursprüngliche Aufgabe (in Google Docs oder Google Chat-Gruppenbereichen) gelöscht. Wenn Sie nur die zugewiesene Aufgabe löschen möchten, rufen Sie die Zuweisungsoberfläche auf und heben Sie die Zuweisung dort auf. Die Standardeinstellung ist "False".
hidden

boolean

Gibt an, ob die Aufgabe ausgeblendet ist. Das ist der Fall, wenn die Aufgabe als erledigt markiert wurde, als die Aufgabenliste zuletzt geleert wurde. Die Standardeinstellung ist "False". Dieses Feld ist schreibgeschützt.
links[].type

string

Der Typ des Links, z.B. „email“.
links[].description

string

Die Beschreibung. In HTML-Sprache: Alles zwischen <a> und </a>.
links[].link

string

Die URL.
assignmentInfo

object (AssignmentInfo)

Nur Ausgabe. Kontextinformationen zu zugewiesenen Aufgaben. Eine Aufgabe kann einem Nutzer zugewiesen werden. Das ist derzeit über Oberflächen wie Docs und Chatbereiche möglich. Dieses Feld wird für Aufgaben ausgefüllt, die dem aktuellen Nutzer zugewiesen sind. Hier wird angegeben, woher die Aufgabe stammt. Dieses Feld ist schreibgeschützt.

AssignmentInfo

Informationen zur Quelle der Aufgabenzuweisung (Dokument, Chatbereich)

JSON-Darstellung 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  // Union field surface_info can be only one of the following:
  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
  // End of list of possible types for union field surface_info.
}
Felder
surfaceType

enum (ContextType)

Nur Ausgabe. Die Art der Oberfläche, von der diese zugewiesene Aufgabe stammt. Derzeit ist die Funktion auf „DOKUMENT“ oder „RAUM“ beschränkt.
Union-Feld surface_info. Informationen zur Oberfläche (Google Docs, Chatbereiche), über die diese Aufgabe zugewiesen wurde. Für surface_info ist nur einer der folgenden Werte zulässig:
driveResourceInfo

object (DriveResourceInfo)

Nur Ausgabe. Informationen zur Drive-Datei, aus der diese Aufgabe stammt. Derzeit kann die Drive-Datei nur ein Dokument sein. Dieses Feld ist schreibgeschützt.
spaceInfo

object (SpaceInfo)

Nur Ausgabe. Informationen zum Chatbereich, aus dem diese Aufgabe stammt. Dieses Feld ist schreibgeschützt.

ContextType"

Das mit der Aufgabe verknüpfte Produkt.

Enums
CONTEXT_TYPE_UNSPECIFIED Unbekannter Wert für den Kontext dieser Aufgabe.
GMAIL Die Aufgabe wird in Gmail erstellt.
DOCUMENT Die Aufgabe wird über ein Dokument zugewiesen.
SPACE Die Aufgabe wird über einen Chatbereich zugewiesen.

DriveResourceInfo

Informationen zur Drive-Ressource, über die eine Aufgabe zugewiesen wurde (z. B. Dokument oder Tabelle).

JSON-Darstellung 
{
  "driveFileId": string,
  "resourceKey": string
}
Felder
driveFileId

string

Nur Ausgabe. Kennung der Datei in der Drive API.
resourceKey

string

Nur Ausgabe. Ressourcenschlüssel, der für den Zugriff auf Dateien erforderlich ist, die über einen freigegebenen Link freigegeben wurden. Nicht für alle Dateien erforderlich. Weitere Informationen finden Sie unter developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informationen zum Chatbereich, über den eine Aufgabe zugewiesen wurde.

JSON-Darstellung 
{
  "space": string
}
Felder
space

string

Nur Ausgabe. Der Chatbereich, aus dem diese Aufgabe stammt. Das Format ist „spaces/{space}“.

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

 Die angegebene Aufgabe wird an eine andere Position in der Zielaufgabenliste verschoben.

patch

 Aktualisiert die angegebene Aufgabe.

update

 Aktualisiert die angegebene Aufgabe.