REST Resource: tasks

Recurso: Task

Representación 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)
  }
}
Campos
kind

string

Solo salida. Tipo de recurso. Siempre es "tasks#task".
id

string

Es el identificador de la tarea.
etag

string

ETag del recurso.
title

string

Es el título de la tarea. La longitud máxima permitida es de 1,024 caracteres.
updated

string

Solo salida. Es la fecha y hora de la última modificación de la tarea (como una marca de tiempo RFC 3339).
parent

string

Solo salida. Es el identificador de la tarea principal. Este campo se omite si es una tarea de nivel superior. Usa el método "move" para mover la tarea a otro elemento superior o al nivel superior. Una tarea principal nunca puede ser una tarea asignada (desde espacios de Chat o Documentos). Este campo es de solo lectura.
position

string

Solo salida. Cadena que indica la posición de la tarea entre sus tareas secundarias bajo la misma tarea principal o en el nivel superior. Si esta cadena es mayor que la cadena de posición correspondiente de otra tarea según el orden lexicográfico, la tarea se posiciona después de la otra tarea en la misma tarea principal (o en el nivel superior). Usa el método "move" para mover la tarea a otra posición.
notes

string

Notas que describen la tarea. Las tareas asignadas desde Documentos de Google no pueden tener notas. Opcional. La longitud máxima permitida es de 8,192 caracteres.
status

string

Es el estado de la tarea. Puede ser "needsAction" o "completed".
due

string

Fecha programada para la tarea (como una marca de tiempo RFC 3339). Opcional. Representa el día en que se debe completar la tarea o en que esta es visible en la cuadrícula del calendario. No representa la fecha límite de la tarea. Solo se registra la información de la fecha; la parte de la hora de la marca de tiempo se descarta cuando se configura este campo. No es posible leer ni escribir la hora para la que se programa una tarea con la API.
completed

string

Fecha de finalización de la tarea (como una marca de tiempo RFC 3339). Este campo se omite si la tarea no se completó.
deleted

boolean

Es una marca que indica si se borró la tarea. Para las tareas asignadas, este campo es de solo lectura. Solo se pueden borrar llamando a tasks.delete, en cuyo caso se borran tanto la tarea asignada como la tarea original (en Documentos o Espacios de Chat). Para borrar solo la tarea asignada, navega a la página de la tarea y anula su asignación desde allí. El valor predeterminado es False.
hidden

boolean

Es una marca que indica si la tarea está oculta. Este es el caso si la tarea se había marcado como completada cuando se borró la lista de tareas por última vez. El valor predeterminado es False. Este campo es de solo lectura.
links[].type

string

Es el tipo de vínculo, p.ej., "email", "generic", "chat_message", "keep_note".
links[].description

string

Es la descripción (puede estar vacía).
links[].link

string

Es la URL.
assignmentInfo

object (AssignmentInfo)

Solo salida. Es la información de contexto para las tareas asignadas. Se puede asignar una tarea a un usuario, lo que actualmente es posible desde plataformas como Documentos y espacios de Chat. Este campo se completa para las tareas asignadas al usuario actual y, además, identifica desde dónde se asignó la tarea. Este campo es de solo lectura.

AssignmentInfo

Es la información sobre la fuente de la asignación de la tarea (documento o espacio de Chat).

Representación 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.
}
Campos
surfaceType

enum (ContextType)

Solo salida. Es el tipo de superficie desde la que se originó esta tarea asignada. Actualmente, se limita a DOCUMENT o SPACE.
Campo de unión surface_info. Es información sobre la plataforma (Documentos, espacios de Chat) desde la que se asignó esta tarea. Las direcciones (surface_info) solo pueden ser una de las siguientes opciones:
driveResourceInfo

object (DriveResourceInfo)

Solo salida. Es información sobre el archivo de Drive del que proviene esta tarea. Actualmente, el archivo de Drive solo puede ser un documento. Este campo es de solo lectura.
spaceInfo

object (SpaceInfo)

Solo salida. Es la información sobre el espacio de Chat desde el que se originó esta tarea. Este campo es de solo lectura.

ContextType

Es el producto asociado a la tarea.

Enums
CONTEXT_TYPE_UNSPECIFIED Valor desconocido para el contexto de esta tarea.
GMAIL La tarea se crea desde Gmail.
DOCUMENT La tarea se asigna desde un documento.
SPACE La tarea se asigna desde un espacio de Chat.

DriveResourceInfo

Es información sobre el recurso de Drive desde el que se asignó una tarea (el documento, la hoja de cálculo, etcétera).

Representación JSON 
{
  "driveFileId": string,
  "resourceKey": string
}
Campos
driveFileId

string

Solo salida. Es el identificador del archivo en la API de Drive.
resourceKey

string

Solo salida. Es la clave de recurso necesaria para acceder a los archivos compartidos a través de un vínculo compartido. No es obligatorio para todos los archivos. Consulta también developers.google.com/drive/api/guides/resource-keys.

SpaceInfo

Es información sobre el espacio de Chat desde el que se asignó una tarea.

Representación JSON 
{
  "space": string
}
Campos
space

string

Solo salida. Es el espacio de Chat desde el que se originó esta tarea. El formato es "spaces/{space}".

Métodos

clear

 Borra todas las tareas completadas de la lista de tareas especificada.

delete

 Borra la tarea especificada de la lista de tareas.

get

 Devuelve la tarea especificada.

insert

 Crea una tarea nueva en la lista de tareas especificada.

list

 Devuelve todas las tareas de la lista de tareas especificada.

move

 Mueve la tarea especificada a otra posición en la lista de tareas de destino.

patch

 Actualiza la tarea especificada.

update

 Actualiza la tarea especificada.