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. Zawsze jest to „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 (w formacie sygnatury czasowej RFC 3339).
parent

string

Tylko dane wyjściowe. Identyfikator zadania nadrzędnego. To pole jest pomijane, jeśli jest to zadanie najwyższego poziomu. Aby przenieść zadanie do innego elementu nadrzędnego lub do najwyższego poziomu, użyj metody „move”. Zadania nadrzędne nie mogą być przypisanymi zadaniami (z pokoi czatu i 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ń pokrewnych w ramach tego samego zadania nadrzędnego lub na najwyższym poziomie. Jeśli według kolejności alfabetycznej ten ciąg jest większy niż odpowiadający mu ciąg innego zadania, zadanie to jest umieszczane po tym drugim zadaniu w ramach tego samego zadania nadrzędnego (lub na najwyższym poziomie). Aby przenieść zadanie w inne miejsce, użyj metody „move”.
notes

string

notatek opisujących zadanie; Zadania przypisane z Dokumentów Google nie mogą zawierać notatek. Opcjonalnie: Maksymalna dozwolona długość: 8192 znaki.
status

string

Stan zadania. Może to być „needsAction” (wymaga działania) lub „completed” (ukończone).
due

string

Termin zadania (w formacie sygnatury czasowej RFC 3339). Opcjonalnie: Data wymagalności zawiera tylko informacje o dacie. Podczas ustawiania daty wymagalności część dotycząca czasu sygnatury czasowej jest ignorowana. Nie można odczytać ani zapisać czasu ukończenia zadania za pomocą interfejsu API.
completed

string

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

boolean

Flaga wskazująca, czy zadanie zostało usunięte. W przypadku przypisanych zadań to pole jest tylko do odczytu. Można je usunąć tylko przez wywołanie funkcji tasks.delete, w której przypadku usunięte zostaną zarówno przypisane zadanie, jak i pierwotne zadanie (w Dokumentach lub pokojach czatu). Aby usunąć tylko przypisane zadanie, przejdź do interfejsu projektu i anuluj jego przypisanie. Wartość domyślna to False (fałsz).
hidden

boolean

Flaga wskazująca, czy zadanie jest ukryte. Dzieje się tak, gdy zadanie zostało oznaczone jako ukończone podczas ostatniego wyczyszczania listy zadań. 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że zostać przypisane do użytkownika. Obecnie jest to możliwe w takich miejscach jak Dokumenty czy pokoje czatu. To pole jest wypełniane w przypadku zadań przypisanych do bieżącego użytkownika i identyfikuje, skąd zostało przypisane. To pole jest tylko do odczytu.

AssignmentInfo

informacje o źródle przypisania zadania (dokument, pokój czatu);

Zapis JSON 
{
  "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.
}
Pola
surfaceType

enum (ContextType)

Tylko dane wyjściowe. Typ powierzchni, na której znajduje się przypisane zadanie. Obecnie ograniczone do opcji DOCUMENT lub SPACE.
Pole unii surface_info. Informacje o platformie (Dokumenty lub pokoje czatu), na której przypisano to zadanie. surface_info może być tylko jednym z tych elementów:
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

Produkt powiązany z zadaniem.

Wartości w polu enum
CONTEXT_TYPE_UNSPECIFIED Nieznana wartość kontekstu tego zadania.
GMAIL Zadanie jest tworzone z Gmaila.
DOCUMENT Zadanie jest przypisane z dokumentu.
SPACE zadanie jest przypisane z 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 wymagany do uzyskania dostępu do plików udostępnionych za pomocą linku. Nie jest wymagane w przypadku wszystkich plików. Zobacz też developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Informacje o pokoju czatu, w którym 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 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 wskazane zadanie na inną pozycję na liście zadań docelowych.

patch

 Aktualizuje określone zadanie.

update

 Aktualizuje określone zadanie.