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,
  "assignmentInfo": {
    object (AssignmentInfo)
  }
}
Поля
kind

string

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

id

string

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

etag

string

ETag ресурса.

title

string

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

updated

string

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

parent

string

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

position

string

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

notes

string

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

status

string

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

due

string

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

completed

string

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

deleted

boolean

Флаг, указывающий, была ли удалена задача. Для назначенных задач это поле доступно только для чтения. Их можно удалить только вызовом Tasks.delete. В этом случае удаляются как назначенная задача, так и исходная задача (в Документах или чат-спейсах). Чтобы удалить только назначенную задачу, перейдите к области назначения и отмените назначение задачи оттуда. По умолчанию установлено значение Ложь.

hidden

boolean

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

links[].type

string

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

links[].description

string

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

links[].link

string

URL-адрес.

assignmentInfo

object ( AssignmentInfo )

Только вывод. Контекстная информация для назначенных задач. Пользователю можно назначить задачу, что в настоящее время возможно с помощью таких инструментов, как Документы и Чат. Это поле заполняется для задач, назначенных текущему пользователю, и указывает, откуда была назначена задача. Это поле доступно только для чтения.

Информация о назначении

Информация об источнике назначения задачи (Документ, Пространство чата).

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

enum ( ContextType )

Только вывод. Тип поверхности, на которой происходит эта назначенная задача. В настоящее время ограничено DOCUMENT или SPACE.

Поле объединения surface_info . Информация о поверхности (Документы, чаты), откуда была назначена эта задача. surface_info может быть только одним из следующих:
driveResourceInfo

object ( DriveResourceInfo )

Только вывод. Информация о файле Диска, откуда возникла эта задача. В настоящее время файл на Диске может быть только документом. Это поле доступно только для чтения.

spaceInfo

object ( SpaceInfo )

Только вывод. Информация о чат-пространстве, откуда возникла эта задача. Это поле доступно только для чтения.

Контексттипе

Продукт, связанный с задачей.

Перечисления
CONTEXT_TYPE_UNSPECIFIED Неизвестное значение для контекста этой задачи.
GMAIL Задача создана из Gmail.
DOCUMENT Задача назначается из документа.
SPACE Задача назначается из чата.

DriveResourceInfo

Информация о ресурсе Диска, откуда была назначена задача (документ, лист и т. д.).

JSON-представление
{
  "driveFileId": string,
  "resourceKey": string
}
Поля
driveFileId

string

Только вывод. Идентификатор файла в Drive API.

resourceKey

string

Только вывод. Ключ ресурса, необходимый для доступа к файлам, к которым предоставлен общий доступ по общей ссылке. Не требуется для всех файлов. См. также Developers.google.com/drive/api/guides/resource-keys.

СпейсИнфо

Информация о чат-пространстве, из которого была назначена задача.

JSON-представление
{
  "space": string
}
Поля
space

string

Только вывод. Пространство чата, откуда возникла эта задача. Формат: «пробелы/{пробел}».

Методы

clear

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

delete

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

get

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

insert

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

list

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

move

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

patch

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

update

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