Ресурс: Задача
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 ( |
Поля | |
---|---|
kind | Только вывод. Тип ресурса. Это всегда «задачи#задача». |
id | Идентификатор задачи. |
etag | ETag ресурса. |
title | Название задачи. Максимальная допустимая длина: 1024 символа. |
updated | Только вывод. Время последнего изменения задачи (как временная метка RFC 3339). |
selfLink | Только вывод. URL-адрес, указывающий на эту задачу. Используется для получения, обновления или удаления этой задачи. |
parent | Только вывод. Идентификатор родительской задачи. Это поле опускается, если это задача верхнего уровня. Используйте метод «переместить», чтобы переместить задачу под другой родительский элемент или на верхний уровень. Родительская задача никогда не может быть назначенной задачей (из Chat Spaces или Docs). Это поле доступно только для чтения. |
position | Только вывод. Строка, указывающая положение задачи среди родственных ей задач в той же родительской задаче или на верхнем уровне. Если эта строка больше, чем соответствующая строка позиции другой задачи в соответствии с лексикографическим порядком, задача располагается после другой задачи в той же родительской задаче (или на верхнем уровне). Используйте метод «переместить», чтобы переместить задачу в другое место. |
notes | Примечания, описывающие задачу. Задачи, назначенные из Документов Google, не могут иметь примечаний. Необязательный. Максимальная допустимая длина: 8192 символа. |
status | Статус задачи. Это либо «needsAction», либо «завершено». |
due | Дата выполнения задачи (как временная метка RFC 3339). Необязательный. В сроке выполнения записывается только информация о дате; временная часть отметки времени отбрасывается при установке срока выполнения. Через API невозможно прочитать или записать время выполнения задачи. |
completed | Дата завершения задачи (как временная метка RFC 3339). Это поле опускается, если задача не выполнена. |
deleted | Флаг, указывающий, была ли удалена задача. Для назначенных задач это поле доступно только для чтения. Их можно удалить только вызовом Tasks.delete. В этом случае удаляются как назначенная задача, так и исходная задача (в Документах или чат-спейсах). Чтобы удалить только назначенную задачу, перейдите к области назначения и отмените назначение задачи оттуда. По умолчанию установлено значение Ложь. |
links[] | Только вывод. Коллекция ссылок. Эта коллекция доступна только для чтения. |
links[].type | Тип ссылки, например «электронная почта». |
links[].description | Описание. В HTML говорят: все между <a> и </a>. |
links[].link | URL-адрес. |
webViewLink | Только вывод. Абсолютная ссылка на задачу в веб-интерфейсе Google Tasks. |
assignmentInfo | Только вывод. Контекстная информация для назначенных задач. Пользователю можно назначить задачу, что в настоящее время возможно с помощью таких инструментов, как Документы и Чат. Это поле заполняется для задач, назначенных текущему пользователю, и указывает, откуда была назначена задача. Это поле доступно только для чтения. |
Информация о назначении
Информация об источнике назначения задачи (Документ, Чат).
JSON-представление |
---|
{ "linkToTask": string, "surfaceType": enum ( |
Поля | |
---|---|
linkToTask | Только вывод. Абсолютная ссылка на исходную задачу в области назначения (Документы, чаты и т. д.). |
surfaceType | Только вывод. Тип поверхности, на которой происходит эта назначенная задача. В настоящее время ограничено DOCUMENT или SPACE. |
Поле объединения surface_info . Информация о поверхности (Документы, Чат-пространства), откуда была назначена эта задача. surface_info может быть только одним из следующих: | |
driveResourceInfo | Только вывод. Информация о файле Диска, откуда возникла эта задача. В настоящее время файл на Диске может быть только документом. Это поле доступно только для чтения. |
spaceInfo | Только вывод. Информация о чат-пространстве, откуда возникла эта задача. Это поле доступно только для чтения. |
Контексттипе
Продукт, связанный с задачей.
Перечисления | |
---|---|
CONTEXT_TYPE_UNSPECIFIED | Неизвестное значение для контекста этой задачи. |
GMAIL | Задача создана из Gmail. |
DOCUMENT | Задача назначается из документа. |
SPACE | Задача назначается из чата. |
DriveResourceInfo
Информация о ресурсе Диска, откуда была назначена задача (документ, лист и т. д.).
JSON-представление |
---|
{ "driveFileId": string, "resourceKey": string } |
Поля | |
---|---|
driveFileId | Только вывод. Идентификатор файла в Drive API. |
resourceKey | Только вывод. Ключ ресурса, необходимый для доступа к файлам, к которым предоставлен общий доступ по общей ссылке. Не требуется для всех файлов. См. также Developers.google.com/drive/api/guides/resource-keys. |
СпейсИнфо
Информация о чат-пространстве, из которого была назначена задача.
JSON-представление |
---|
{ "space": string } |
Поля | |
---|---|
space | Только вывод. Пространство чата, откуда возникла эта задача. Формат: «пробелы/{пробел}». |
Методы | |
---|---|
| Удаляет все выполненные задачи из указанного списка задач. |
| Удаляет указанную задачу из списка задач. |
| Возвращает указанную задачу. |
| Создает новую задачу в указанном списке задач. |
| Возвращает все задачи в указанном списке задач. |
| Перемещает указанную задачу в другую позицию в списке задач назначения. |
| Обновляет указанную задачу. |
| Обновляет указанную задачу. |