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 ( |
Campos | |
---|---|
kind |
Solo salida. Tipo del recurso. Siempre es "tareas#tarea". |
id |
Identificador de tarea. |
etag |
ETag del recurso. |
title |
Título de la tarea. Longitud máxima permitida: 1,024 caracteres. |
updated |
Solo salida. Hora de la última modificación de la tarea (como una marca de tiempo RFC 3339). |
selfLink |
Solo salida. URL que dirige a esta tarea. Se usa para recuperar, actualizar o borrar esta tarea. |
parent |
Solo salida. Identificador de tarea superior. Este campo se omite si es una tarea de nivel superior. Utiliza el botón "Mover" para mover la tarea bajo 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 |
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). Utiliza el botón "Mover" para mover la tarea a otra posición. |
notes |
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 |
Estado de la tarea. Esto es “needsAction” o "completado". |
due |
Fecha de vencimiento de la tarea (como una marca de tiempo RFC 3339). Opcional. La fecha límite solo registra información sobre la fecha. 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 |
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 |
Marca que indica si se borró la tarea. Para las tareas asignadas, este campo es de solo lectura. Solo se pueden borrar llamando a task.delete, en cuyo caso se borran tanto la tarea asignada como la original (en Documentos o Espacios de Chat). Para borrar solo la tarea asignada, navega a la plataforma de la tarea y anula la asignación desde allí. El valor predeterminado es False. |
links[] |
Solo salida. Es una colección de vínculos. Esta colección es de solo lectura. |
links[].type |
Tipo de vínculo, p.ej., "correo electrónico". |
links[].description |
Es la descripción. En HTML diga: Todo entre <a> y </a>. |
links[].link |
La URL. |
webViewLink |
Solo salida. Es un vínculo absoluto a la tarea en la IU web de Google Tasks. |
assignmentInfo |
Solo salida. Información contextual para las tareas asignadas. Se puede asignar una tarea a un usuario, y esto es posible desde plataformas como Documentos y Espacios de Chat. Este campo se propaga 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
Información sobre la fuente de la asignación de la tarea (documento, espacio de Chat).
Representación JSON |
---|
{ "linkToTask": string, "surfaceType": enum ( |
Campos | |
---|---|
linkToTask |
Solo salida. Es un vínculo absoluto a la tarea original en la superficie de la tarea (Documentos, espacios de Chat, etcétera). |
surfaceType |
Solo salida. El tipo de superficie de la que se origina esta tarea asignada. Actualmente limitado a DOCUMENT o SPACE. |
Campo de unión surface_info . 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 |
Solo salida. Información sobre el archivo de Drive donde se origina esta tarea. Actualmente, el archivo de Drive solo puede ser un documento. Este campo es de solo lectura. |
spaceInfo |
Solo salida. Información sobre el espacio de Chat en el que se origina 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 |
Se creará la tarea en 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 (documento, hoja de cálculo, etcétera).
Representación JSON |
---|
{ "driveFileId": string, "resourceKey": string } |
Campos | |
---|---|
driveFileId |
Solo salida. Es el identificador del archivo en la API de Drive. |
resourceKey |
Solo salida. Se requiere la clave de recurso para acceder a los archivos compartidos a través de un vínculo compartido. No es obligatorio para todos los archivos. Consulta también developer.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 |
Solo salida. El espacio de Chat en el que se origina esta tarea. El formato es "spaces/{space}". |
Métodos |
|
---|---|
|
Borra todas las tareas completadas de la lista de tareas especificada. |
|
Borra la tarea especificada de la lista de tareas. |
|
Devuelve la tarea especificada. |
|
Crea una tarea nueva en la lista de tareas especificada. |
|
Muestra todas las tareas de la lista de tareas especificada. |
|
Mueve la tarea especificada a otra posición en la lista de tareas de destino. |
|
Actualiza la tarea especificada. |
|
Actualiza la tarea especificada. |