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
}
Campos
kind

string

Solo salida. Tipo del recurso. Siempre es "tareas#tarea".

id

string

Identificador de tarea.

etag

string

ETag del recurso.

title

string

Título de la tarea. Longitud máxima permitida: 1,024 caracteres.

updated

string

Solo salida. Hora de la última modificación de la tarea (como una marca de tiempo RFC 3339).

parent

string

Solo salida. Identificador de tarea superior. Este campo se omite si es una tarea de nivel superior. Este campo es de solo lectura. Usa el método “move” para mover la tarea bajo un elemento superior diferente o al nivel superior.

position

string

Solo salida. Es una cadena que indica la posición de la tarea entre las tareas del mismo nivel 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 de acuerdo con el orden lexicográfico, la tarea se posiciona después de la otra 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. Opcional. Longitud máxima permitida: 8,192 caracteres.

status

string

Estado de la tarea. Puede ser “needsAction” o “completed”.

due

string

Fecha de vencimiento de la tarea (como una marca de tiempo RFC 3339). Opcional. La fecha límite solo registra la información de la fecha; la parte de la hora de la marca de tiempo se descarta cuando se configura la fecha límite. No es posible leer ni escribir la hora a la que vencerá una tarea mediante 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 ha completado.

deleted

boolean

Marca que indica si se borró la tarea. El valor predeterminado es False.

hidden

boolean

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

links[].type

string

Tipo de vínculo; p.ej., "correo electrónico".

links[].description

string

Es la descripción. En HTML diga lo siguiente: todo entre <a> y </a>.

links[].link

string

La URL.

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

Muestra todas las tareas de la lista de tareas especificada.

move

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

patch

Actualiza la tarea especificada.

update

Actualiza la tarea especificada.