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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
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. Mit der Schaltfläche „Verschieben“ , um die Aufgabe unter ein anderes übergeordnetes Element oder in die oberste Ebene zu verschieben. Eine übergeordnete Aufgabe kann nie als Aufgabe zugewiesen werden (aus Chatbereichen oder Google Docs). Dieses Feld ist schreibgeschützt.

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. Mit der Schaltfläche „Verschieben“ um die Aufgabe an eine andere Position zu verschieben.

notes

string

Notizen, die die Aufgabe beschreiben. Aufgaben, die über Google Docs zugewiesen wurden, können keine Notizen enthalten. Optional. Maximal zulässige Länge: 8.192 Zeichen.

status

string

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

due

string

Fälligkeitsdatum der Aufgabe (als RFC 3339-Zeitstempel). Optional. Beim Fälligkeitsdatum werden nur Datumsangaben erfasst. Die Uhrzeit des Zeitstempels wird beim Festlegen des Abgabetermins 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. 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 Docs oder Chatbereichen) gelöscht. Wenn Sie nur die zugewiesene Aufgabe löschen möchten, rufen Sie die Aufgabenoberfläche auf und heben Sie die Zuweisung der Aufgabe dort auf. 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. „email“.

links[].description

string

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

links[].link

string

Die URL.

assignmentInfo

object (AssignmentInfo)

Nur Ausgabe. Kontextinformationen für zugewiesene Aufgaben. Einem Nutzer kann eine Aufgabe zugewiesen werden, was derzeit über Oberflächen wie Google Docs und Chatbereiche möglich ist. Dieses Feld wird für Aufgaben ausgefüllt, die dem aktuellen Nutzer zugewiesen wurden. Es gibt an, von wo die Aufgabe zugewiesen wurde. 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 Oberflächentyp, aus dem diese zugewiesene Aufgabe stammt. Derzeit beschränkt auf DOCUMENT oder SPACE.

Union-Feld surface_info. Informationen zur Oberfläche (Dokumente, Chatbereiche), aus 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 die 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 aus einem Dokument zugewiesen.
SPACE Die Aufgabe wird über einen Chatbereich zugewiesen.

DriveResourceInfo

Informationen zur Drive-Ressource, aus der eine Aufgabe zugewiesen wurde (Dokument, Tabellenblatt usw.).

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

string

Nur Ausgabe. Die Kennzeichnung der Datei in der Drive API.

resourceKey

string

Nur Ausgabe. Ressourcenschlüssel für den Zugriff auf Dateien erforderlich, 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, 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.