Mover tarefa no Google Tasks, por uma API
Move uma tarefa para outra posição, sob outra tarefa-mãe ou para outra lista de tarefas. Sem parent a tarefa vai para o nível principal, e sem previous vai para a primeira posição. Tarefas recorrentes não podem ir para outra lista.
- Identificador
- google_tasks_move_task
A chamada
POST https://connect.reportei.com/api/tools/google_tasks_move_task/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"tasklist": "<tasklist>",
"task": "<task>"
}
}Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.
Parâmetros
As descrições dos parâmetros seguem a documentação oficial do app, em inglês.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tasklist | string | Sim | Id of the current task list of the task, from List task lists. |
| task | string | Sim | Task id from List tasks. |
| parent | string | Não | Task id from List tasks of the new parent, which makes the task a subtask. It must be in the destination list and cannot be hidden, assigned or repeating. |
| previous | string | Não | Task id from List tasks of the sibling the task goes after. It must be in the destination list and cannot be hidden. |
| destinationTasklist | string | Não | Task list id from List task lists to move the task to. Leave it out to move the task inside its current list. |
Conexões possíveis
O seu cliente conecta a conta do Google Tasks uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/google_tasks, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
A resposta
Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.
Pronta para agentes de IA
O input desta tool é um JSON Schema, disponível em GET /api/tools/google_tasks_move_task. Ele vira a definição de tool do seu agente sem conversão.
Outras tools do Google Tasks
- Listar listas de tarefasGETLista as listas de tarefas da conta, com id e title. Use o id de um item como tasklist nas outras ferramentas. Passe nextPageToken como pageToken para ler a próxima página.
- Criar lista de tarefasPOSTCria uma lista de tarefas e a retorna com seu id. Uma conta pode ter até 2000 listas de tarefas.
- Atualizar lista de tarefasPATCHRenomeia uma lista de tarefas.
- Listar tarefasGETLista as tarefas de uma lista de tarefas, subtarefas incluídas, com id, title, notes, status, due, completed e parent, o id da tarefa-mãe de uma subtarefa. Tarefas concluídas nos apps do Google ficam ocultas: defina showHidden como true para vê-las. Passe nextPageToken como pageToken para ler a próxima página.
- Obter tarefaGETRetorna uma tarefa com title, notes, status, data de vencimento, horário de conclusão, parent e webViewLink, o link da tarefa no app web do Google Tasks.
- Criar tarefaPOSTCria uma tarefa em uma lista, na primeira posição, a menos que previous diga outra. Passe parent para criá-la como subtarefa. Tarefas atribuídas a partir do Google Docs ou de espaços do Chat não podem ser criadas aqui.
- Atualizar tarefaPATCHAltera o título, as notas, a data de vencimento ou o status de uma tarefa; só os campos enviados mudam. Defina status como completed para concluir a tarefa, ou como needsAction para reabri-la. Para mudar sua lista, parent ou posição, use Mover tarefa.
- Excluir tarefaDELETEExclui uma tarefa. Uma tarefa atribuída a partir do Google Docs ou de espaços do Chat também é excluída lá.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
