Method: tasks.move

Mueve la tarea especificada a otra posición en la lista de tareas de destino. Si no se especifica la lista de destino, la tarea se moverá dentro de su lista actual. Esto puede incluir colocarla como tarea secundaria en un elemento superior nuevo o moverla a una posición diferente entre sus tareas hermanas. Un usuario puede tener hasta 2,000 subtareas por tarea.

Solicitud HTTP

POST https://tasks.googleapis.com/tasks/v1/lists/{tasklist}/tasks/{task}/move

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
tasklist

string

Es el identificador de la lista de tareas.

task

string

Es el identificador de la tarea.

Parámetros de consulta

Parámetros
parent

string

Opcional. Es el nuevo identificador de tarea superior. Si la tarea se mueve al nivel superior, se omite este parámetro. La tarea establecida como superior debe existir en la lista de tareas y no se puede ocultar.

Excepciones: 1. Las tareas asignadas no se pueden establecer como tareas principales (tener subtareas) ni trasladarse a una tarea principal (convertirse en subtareas). 2. Las tareas que están completadas y ocultas no se pueden anidar, por lo que el campo superior debe estar vacío.

previous

string

Opcional. Nuevo identificador de tarea anterior del hermano. Si la tarea se mueve a la primera posición entre sus tareas hermanas, se omite este parámetro. La tarea establecida como anterior debe existir en la lista de tareas y no se puede ocultar.

Excepciones: 1. Las tareas que están completadas y ocultas solo se pueden mover a la posición 0, por lo que el campo anterior debe estar vacío.

destinationTasklist

string

Opcional. Es el identificador de la lista de tareas de destino. Si se establece, la tarea se mueve de la lista de tareas a la lista de destinationTasklist. De lo contrario, la tarea se moverá dentro de su lista actual. Por el momento, no se pueden mover tareas recurrentes entre listas.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Task.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/tasks

Para obtener más información, consulta la Guía de autorización.