REST Resource: tasks

Zasób: zadanie

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
}
Pola
kind

string

Typ zasobu. To zawsze jest „tasks#task”.

id

string

Identyfikator zadania.

etag

string

ETag zasobu.

title

string

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

updated

string

Ostatnia modyfikacja zadania (jako sygnatura czasowa RFC 3339).

parent

string

Identyfikator zadania nadrzędnego. To pole jest pomijane, jeśli jest to zadanie najwyższego poziomu. To pole jest tylko do odczytu. Użyj metody „przenieś”, aby przenieść zadanie pod inny element nadrzędny lub na najwyższy poziom.

position

string

Ciąg tekstowy określają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 niż odpowiadający mu ciąg pozycji innego zadania według kolejności leksykograficznej, zadanie jest umieszczane po innym zadaniu w ramach tego samego zadania nadrzędnego (lub na najwyższym poziomie). To pole jest tylko do odczytu. Użyj metody „move”, aby przenieść zadanie w inne miejsce.

notes

string

Notatki opisujące zadanie. Opcjonalnie. Maksymalna dozwolona długość: 8192 znaki.

status

string

Stan zadania. Parametr ma wartość „needsAction” lub „completed”.

due

string

Termin zadania (jako sygnatura czasowa RFC 3339). Opcjonalnie. Termin rejestruje tylko informacje o dacie; część sygnatury czasowej związana z czasem jest odrzucana podczas ustawiania terminu. Nie można odczytać ani zapisać godziny, do której należy zadanie, korzystając z interfejsu API.

completed

string

Data ukończenia zadania (jako 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. Wartością domyślną jest Fałsz.

hidden

boolean

Flaga z informacją, czy zadanie jest ukryte. Zadanie może być oznaczone jako ukończone, gdy lista zadań była ostatnio czyszczona. Wartością domyślną jest Fałsz. To pole jest tylko do odczytu.

links[].type

string

Typ linku, np. „e-mail”.

links[].description

string

Opis. Mów w języku HTML: wszystko między <a> a </a>.

links[].link

string

Adres URL.

Metody

clear

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

delete

Usuwa określone zadanie z listy zadań.

get

Zwraca określone zadanie.

insert

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

list

Zwraca wszystkie zadania na określonej liście zadań.

move

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

patch

Aktualizuje określone zadanie.

update

Aktualizuje określone zadanie.