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. Typ der Ressource. Dies ist immer „tasks#task“.
id

string

Aufgaben-ID.
etag

string

ETag der Ressource.
title

string

Titel der Aufgabe. Die maximal zulässige Länge beträgt 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 Aufgabe auf oberster Ebene handelt. Mit der Methode „move“ können Sie die Aufgabe in ein anderes übergeordnetes Element oder auf die oberste Ebene verschieben. Eine übergeordnete Aufgabe kann nie eine zugewiesene Aufgabe (aus Chatbereichen, Google Docs) sein. Dieses Feld ist schreibgeschützt.
position

string

Nur Ausgabe. String, der die Position der Aufgabe unter den gleichgeordneten Aufgaben unter derselben übergeordneten Aufgabe oder auf der obersten Ebene angibt. Wenn dieser String gemäß der lexikografischen Ordnung größer als der entsprechende Positionsstring einer anderen Aufgabe ist, wird die Aufgabe nach der anderen Aufgabe unter derselben übergeordneten Aufgabe (oder auf der obersten Ebene) positioniert. Verwenden Sie die Methode „move“, um die Aufgabe an eine andere Position zu verschieben.
notes

string

Notizen zur Beschreibung der Aufgabe. Aufgaben, die aus Google Docs zugewiesen werden, können keine Notizen enthalten. Optional. Die maximal zulässige Länge beträgt 8.192 Zeichen.
status

string

Status der Aufgabe. Das Feld kann entweder „needsAction“ oder „completed“ sein.
due

string

Geplantes Datum für die Aufgabe (als RFC 3339-Zeitstempel). Optional. Das ist der Tag, an dem die Aufgabe erledigt werden soll oder an dem die Aufgabe im Kalenderraster sichtbar ist. Es gibt nicht die Frist der Aufgabe an. Es werden nur Datumsangaben erfasst. Der Zeitanteil des Zeitstempels wird beim Festlegen dieses Felds verworfen. Es ist nicht möglich, die Zeit, für die eine Aufgabe geplant ist, über die API zu lesen oder zu schreiben.
completed

string

Fertigstellungsdatum der Aufgabe (als RFC 3339-Zeitstempel). Dieses Feld wird weggelassen, wenn die Aufgabe 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 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 der Aufgabe auf. Die Standardeinstellung ist "False".
hidden

boolean

Flag, das angibt, ob die Aufgabe ausgeblendet ist. Das ist der Fall, wenn die Aufgabe als abgeschlossen markiert wurde, als die Aufgabenliste zuletzt gelöscht wurde. Die Standardeinstellung ist "False". Dieses Feld ist schreibgeschützt.
links[].type

string

Typ des Links, z.B. „email“, „generic“, „chat_message“, „keep_note“.
links[].description

string

Die Beschreibung (kann leer sein).
links[].link

string

Die URL.
assignmentInfo

object (AssignmentInfo)

Nur Ausgabe. Kontextinformationen für zugewiesene Aufgaben. Eine Aufgabe kann einem Nutzer zugewiesen werden. Das ist derzeit auf Oberflächen wie Google Docs und Google Chat-Gruppenbereichen möglich. Dieses Feld wird für Aufgaben ausgefüllt, die dem aktuellen Nutzer zugewiesen sind, und gibt an, 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. Der Typ der Oberfläche, aus der diese zugewiesene Aufgabe stammt. Derzeit auf DOCUMENT oder SPACE beschränkt.
Union-Feld surface_info. Informationen zur Oberfläche (Docs, Chat-Gruppenbereiche), von der 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 Produkt, das mit der Aufgabe verknüpft ist.

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, aus der eine Aufgabe zugewiesen wurde (z. B. das Dokument oder die 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 erforderlich, um auf Dateien zuzugreifen, die über einen freigegebenen Link geteilt wurden. Nicht für alle Dateien erforderlich. Weitere Informationen finden Sie unter developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informationen zum Chatbereich, aus dem 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

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

patch

 Aktualisiert die angegebene Aufgabe.

update

 Aktualisiert die angegebene Aufgabe.