REST Resource: tasks

Zasób: Task

Zapis JSON 
{
  "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)
  }
}
Pola
kind

string

Tylko dane wyjściowe. Typ zasobu. Jest to zawsze „tasks#task”.
id

string

Identyfikator zadania.
etag

string

ETag zasobu.
title

string

Tytuł zadania. Maksymalna dozwolona długość: 1024 znaki.
updated

string

Tylko dane wyjściowe. Czas ostatniej modyfikacji zadania (sygnatura czasowa RFC 3339).
parent

string

Tylko dane wyjściowe. Identyfikator zadania nadrzędnego. Jeśli jest to zadanie najwyższego poziomu, to pole jest pomijane. Użyj metody „przenieś”, aby przenieść zadanie do innego elementu nadrzędnego lub na najwyższy poziom. Zadanie nadrzędne nigdy nie może być przypisane (z pokoi czatu lub Dokumentów). To pole jest tylko do odczytu.
position

string

Tylko dane wyjściowe. Ciąg znaków wskazujący pozycję zadania wśród zadań równorzędnych w ramach tego samego zadania nadrzędnego lub na najwyższym poziomie. Jeśli ten ciąg znaków jest większy od odpowiedniego ciągu znaków pozycji innego zadania zgodnie z porządkiem leksykograficznym, zadanie jest umieszczane po innym zadaniu w ramach tego samego zadania nadrzędnego (lub na najwyższym poziomie). Użyj metody „move”, aby przenieść zadanie w inne miejsce.
notes

string

Notatki opisujące zadanie. Zadania przypisane w Dokumentach Google nie mogą zawierać notatek. Opcjonalnie: Maksymalna dozwolona długość: 8192 znaki.
status

string

Stan zadania. Może to być „needsAction” lub „completed”.
due

string

Zaplanowana data zadania (sygnatura czasowa RFC 3339). Opcjonalnie: Jest to dzień, w którym zadanie powinno zostać wykonane lub w którym jest widoczne w siatce kalendarza. Nie jest to termin wykonania zadania. Rejestrowane są tylko informacje o dacie. Podczas ustawiania tego pola część sygnatury czasowej dotycząca godziny jest odrzucana. Za pomocą interfejsu API nie można odczytywać ani zapisywać czasu, na który zaplanowano zadanie.
completed

string

Data ukończenia zadania (sygnatura czasowa RFC 3339). To pole jest pomijane, jeśli zadanie nie zostało ukończone.
deleted

boolean

Flaga z informacją, czy zadanie zostało usunięte. W przypadku przypisanych zadań to pole jest tylko do odczytu. Można je usunąć tylko za pomocą wywołania tasks.delete. W takim przypadku usuwane są zarówno przypisane zadanie, jak i oryginalne zadanie (w Dokumentach lub pokojach w Google Chat). Aby usunąć tylko przypisane zadanie, przejdź do powierzchni przypisania i anuluj przypisanie zadania. Wartość domyślna to False (fałsz).
hidden

boolean

Flaga z informacją, czy zadanie jest ukryte. Dzieje się tak, jeśli zadanie zostało oznaczone jako ukończone, gdy lista zadań była ostatnio czyszczona. Wartość domyślna to False (fałsz). To pole jest tylko do odczytu.
links[].type

string

Typ linku, np. „email”, „generic”, „chat_message”, „keep_note”.
links[].description

string

Opis (może być pusty).
links[].link

string

Adres URL.
assignmentInfo

object (AssignmentInfo)

Tylko dane wyjściowe. informacje kontekstowe dotyczące przypisanych zadań; Zadanie można przypisać do użytkownika. Obecnie jest to możliwe na platformach takich jak Dokumenty i pokoje czatu. To pole jest wypełniane w przypadku zadań przypisanych do bieżącego użytkownika i określa, skąd zostało przypisane zadanie. To pole jest tylko do odczytu.

AssignmentInfo

Informacje o źródle przypisania zadania (dokument, pokój czatu).

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

  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
}
Pola
surfaceType

enum (ContextType)

Tylko dane wyjściowe. Typ platformy, z której pochodzi przypisane zadanie. Obecnie dotyczy tylko dokumentów i pokoi.
Pole zbiorcze surface_info. Informacje o platformie (Dokumenty, pokoje czatu), z której przypisano to zadanie. surface_info może mieć tylko jedną z tych wartości:
driveResourceInfo

object (DriveResourceInfo)

Tylko dane wyjściowe. Informacje o pliku na Dysku, z którego pochodzi to zadanie. Obecnie plik na Dysku może być tylko dokumentem. To pole jest tylko do odczytu.
spaceInfo

object (SpaceInfo)

Tylko dane wyjściowe. Informacje o pokoju czatu, z którego pochodzi to zadanie. To pole jest tylko do odczytu.

ContextType

Usługa powiązana z zadaniem.

Wartości w polu enum
CONTEXT_TYPE_UNSPECIFIED Nieznana wartość kontekstu tego zadania.
GMAIL Zadanie zostanie utworzone w Gmailu.
DOCUMENT Zadanie jest przypisane z dokumentu.
SPACE Zadanie jest przypisane w pokoju czatu.

DriveResourceInfo

Informacje o zasobie na Dysku, z którego przypisano zadanie (dokument, arkusz itp.).

Zapis JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
Pola
driveFileId

string

Tylko dane wyjściowe. Identyfikator pliku w interfejsie Drive API.
resourceKey

string

Tylko dane wyjściowe. Klucz zasobu jest wymagany do uzyskania dostępu do plików udostępnionych za pomocą linku udostępnionego. Nie jest wymagane w przypadku wszystkich plików. Zobacz też developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informacje o pokoju czatu, z którego przypisano zadanie.

Zapis JSON 
{
  "space": string
}
Pola
space

string

Tylko dane wyjściowe. Pokój czatu, z którego pochodzi to zadanie. Format to „spaces/{space}”.

Metody

clear

 Usuwa wszystkie ukończone zadania z określonej listy zadań.

delete

 Usuwa z listy zadań określone zadanie.

get

 Zwraca określone zadanie.

insert

 Tworzy nowe zadanie na określonej liście zadań.

list

 Zwraca wszystkie zadania z określonej listy zadań.

move

 Przenosi określone zadanie na inne miejsce na liście zadań docelowych.

patch

 Aktualizuje określone zadanie.

update

 Aktualizuje określone zadanie.