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

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). Utiliza el botón "Mover" 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. Esto es “needsAction” o "completado".

due

string

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

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

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ó la lista de tareas por última vez. 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: Todo entre <a> y </a>.

links[].link

string

La URL.

assignmentInfo

object (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 (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 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

object (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

object (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

string

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

resourceKey

string

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

string

Solo salida. El espacio de Chat en el que se origina 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

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.