REST Resource: tasks

Ресурс: Задача

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
}
Поля
kind

string

Тип ресурса. Это всегда «задачи#задача».

id

string

Идентификатор задачи.

etag

string

ETag ресурса.

title

string

Название задачи. Максимальная допустимая длина: 1024 символа.

updated

string

Время последнего изменения задачи (как временная метка RFC 3339).

parent

string

Идентификатор родительской задачи. Это поле опускается, если это задача верхнего уровня. Это поле доступно только для чтения. Используйте метод «переместить», чтобы переместить задачу под другой родительский элемент или на верхний уровень.

position

string

Строка, указывающая положение задачи среди родственных ей задач в той же родительской задаче или на верхнем уровне. Если эта строка больше, чем соответствующая строка позиции другой задачи в соответствии с лексикографическим порядком, задача располагается после другой задачи в той же родительской задаче (или на верхнем уровне). Это поле доступно только для чтения. Используйте метод «переместить», чтобы переместить задачу в другое место.

notes

string

Примечания, описывающие задачу. Необязательный. Максимальная допустимая длина: 8192 символа.

status

string

Статус задачи. Это либо «needsAction», либо «завершено».

due

string

Дата выполнения задачи (как временная метка RFC 3339). Необязательный. В сроке выполнения записывается только информация о дате; временная часть отметки времени отбрасывается при установке срока выполнения. Через API невозможно прочитать или записать время выполнения задачи.

completed

string

Дата завершения задачи (как временная метка RFC 3339). Это поле опускается, если задача не выполнена.

deleted

boolean

Флаг, указывающий, была ли удалена задача. По умолчанию установлено значение Ложь.

hidden

boolean

Флаг, указывающий, скрыта ли задача. Это тот случай, если задача была помечена как завершенная при последней очистке списка задач. По умолчанию установлено значение Ложь. Это поле доступно только для чтения.

links[].type

string

Тип ссылки, например «электронная почта».

links[].description

string

Описание. В HTML говорят: все между <a> и </a>.

links[].link

string

URL-адрес.

Методы

clear

Удаляет все выполненные задачи из указанного списка задач.

delete

Удаляет указанную задачу из списка задач.

get

Возвращает указанную задачу.

insert

Создает новую задачу в указанном списке задач.

list

Возвращает все задачи в указанном списке задач.

move

Перемещает указанную задачу на другую позицию в списке задач.

patch

Обновляет указанную задачу.

update

Обновляет указанную задачу.