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

Только вывод. Тип ресурса. Всегда "tasks#task".

id

string

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

etag

string

ETag ресурса.

title

string

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

updated

string

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

parent

string

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

position

string

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

notes

string

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

status

string

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

due

string

Запланированная дата задачи (в виде временной метки RFC 3339). Необязательно. Это день, когда задача должна быть выполнена или когда она будет видна в календаре. Это не крайний срок выполнения задачи. Записывается только информация о дате; при настройке этого поля временная часть метки отбрасывается. С помощью API невозможно прочитать или записать время, на которое запланирована задача.

completed

string

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

deleted

boolean

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

hidden

boolean

Флаг, указывающий, скрыта ли задача. Это происходит, если задача была отмечена как выполненная при последней очистке списка задач. Значение по умолчанию — False. Это поле доступно только для чтения.

links[].type

string

Тип ссылки, например, «email», «generic», «chat_message», «keep_note».

links[].description

string

Описание (может быть пустым).

links[].link

string

URL-адрес.

assignmentInfo

object ( AssignmentInfo )

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

Информация о задании

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

JSON-представление 
{
  "linkToTask": string,
  "surfaceType": enum (ContextType),

  "driveResourceInfo": {
    object (DriveResourceInfo)
  },
  "spaceInfo": {
    object (SpaceInfo)
  }
}
Поля
surfaceType

enum ( ContextType )

Только вывод. Тип поверхности, из которой исходит эта назначенная задача. В настоящее время ограничено ДОКУМЕНТОМ или ПРОСТРАНСТВОМ.

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

object ( DriveResourceInfo )

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

spaceInfo

object ( SpaceInfo )

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

ContextType

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

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

DriveResourceInfo

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

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

string

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

resourceKey

string

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

SpaceInfo

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

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

string

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

Методы

clear

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

delete

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

get

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

insert

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

list

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

move

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

patch

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

update

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