REST Resource: tasks

Recurso: Tarea

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. Es el 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. Longitud máxima permitida: 1,024 caracteres.
updated

string

Solo salida. Es la 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 superior. Este campo se omite si se trata de una tarea de nivel superior. Usa el método "move" para mover la tarea a un elemento superior diferente o al nivel superior. Una tarea superior nunca puede ser una tarea asignada (desde espacios de Chat o Documentos). Este campo es de solo lectura.
position

string

Solo salida. Es una cadena que indica la posición de la tarea entre sus tareas hermanas en la misma tarea superior 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 coloca después de la otra tarea en la misma tarea superior (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. Longitud máxima permitida: 8,192 caracteres.
status

string

Estado de la tarea. Puede ser "needsAction" o "completed".
due

string

Es la fecha límite de la tarea (como una marca de tiempo RFC 3339). Opcional. La fecha límite solo registra información de fecha. La parte de hora de la marca de tiempo se descarta cuando se establece la fecha límite. No es posible leer ni escribir la hora en que vence una tarea a través de la API.
completed

string

Es la 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

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

boolean

Marca que indica si la tarea está oculta. Este es el caso si la tarea se marcó 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

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

string

La URL.
assignmentInfo

object (AssignmentInfo)

Solo salida. Información contextual de 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 propaga para las tareas asignadas al usuario actual y identifica desde dónde se asignó la tarea. Este campo es de solo lectura.

AssignmentInfo

Es la información sobre la fuente de la tarea asignada (documento, 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. El tipo de plataforma de la que proviene esta tarea asignada. Actualmente, se limita a DOCUMENTO o ESPACIO.
Campo de unión surface_info. Información sobre la plataforma (Docs, 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. 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. 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 con la tarea.

Enumeraciones
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

Información sobre el recurso de Drive desde el que se asignó una tarea (el documento, la hoja, 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

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

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

string

Solo salida. 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

 Muestra la tarea especificada.

insert

 Crea una tarea nueva en la lista de tareas especificada.

list

 Muestra 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.