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

string

Tipo de recurso. Siempre es "tareas#tarea".

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

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

parent

string

Es el identificador de la tarea superior. Este campo se omite si es una tarea de nivel superior. Este campo es de solo lectura. Usa el método "mover" para mover la tarea a otro nivel superior o al nivel superior.

position

string

Es una cadena que indica la posición de la tarea entre las tareas del mismo nivel en la misma tarea principal o en el nivel superior. Si esta string es mayor que la string 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). Este campo es de solo lectura. Utiliza el método "mover" para mover la tarea a otra posición.

notes

string

Notas que describen la tarea. Opcional. La longitud máxima permitida es de 8,192 caracteres.

status

string

Estado de la tarea. Es "needsAction" o "completed".

due

string

Es la fecha de vencimiento de la tarea (como una marca de tiempo RFC 3339). Opcional. La fecha límite solo registra información sobre las fechas; la hora de la marca de tiempo se descarta cuando se configura la fecha límite. No es posible leer ni escribir la hora de vencimiento de una tarea mediante la API.

completed

string

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. 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 la última vez que se borró 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

La descripción. En HTML, habla: todo entre <a> y </a>.

links[].link

string

Es 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

Muestra la tarea especificada.

insert

Crea una tarea nueva en la lista de tareas especificada.

list

Muestra todas las tareas en 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.