Partilhar via


Microsoft To-Do (Negócios)

O Microsoft To-Do é um aplicativo inteligente de gerenciamento de tarefas que facilita o planejamento e o gerenciamento do seu dia. Ligue-se ao Microsoft To-Do para gerir as suas tarefas a partir de vários serviços. Você pode executar ações como criar tarefas.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Microsoft
URL Suporte do Microsoft LogicApps
Microsoft Power Automate Suporte
Suporte do Microsoft Power Apps
Metadados do conector
Editora Microsoft
Sítio Web https://todo.microsoft.com/tasks/

Problemas conhecidos e limitações

A API To Do tem a maioria dos recursos de Tarefa do Outlook . Observe que a entidade outlookTaskGroup, as propriedades estendidas e as propriedades atribuídas, proprietárias da entidade outlookTask não estarão disponíveis na API de Tarefas Pendentes.

Descontinuação de APIs de tarefas do Outlook

As APIs de tarefas do Graph Outlook deixarão de retornar dados após 20 de fevereiro de 2023.

As operações listadas aqui serão afetadas pela descontinuação da API e pararão para retornar dados após 20 de fevereiro de 2023.


As operações listadas aqui não serão afetadas pela descontinuação da API.


Devblogs na versão da API To Do

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos
Frequência das sondagens de desencadeamento 1 120 segundos

Ações

Adicionar um to-do (V2) [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Adicionar um to-do (V3).

Esta operação é usada para criar um to-do na lista de to-do especificada (o padrão é To-Do).

Adicionar um to-do (V3)

Esta operação é usada para criar um to-do na lista de to-do especificada.

Adicionar um to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Adicionar um to-do (V3).

Esta operação é usada para criar um to-do na lista de to-do especificada (o padrão é To-Do).

Atualizar uma lista de to-do

Esta operação é usada para atualizar uma lista de to-do específica.

Atualização to-do (V2)

Esta operação é usada para atualizar um to-doespecífico.

Atualização to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use o Update to-do (V2).

Esta operação é usada para atualizar um to-doespecífico.

Criar uma lista de to-do (V2)

Esta operação é usada para criar uma nova lista de to-do.

Criar uma lista de to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Criar uma lista de to-do (V2).

Esta operação é usada para criar uma nova lista de to-do.

Excluir to-do (V2)

Esta operação é usada para excluir uma tarefa.

Excluir uma lista de to-do

Esta operação é usada para excluir uma lista de to-do específica.

Listar to-dopor pasta (V2)

Esta operação é usada para recuperar todos os to-dode uma lista específica.

Listar to-dopor pasta [DEPRECATED]

Esta ação foi preterida. Em vez disso, use List to-do's by folder (V2).

Esta operação é usada para recuperar todos os to-dode uma lista específica.

Listar todas as listas de to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Listar todas as to-do listas (V2).

Retorna uma lista de todas as listas de to-do.

Listar todas as listas to-do (V2)

Retorna uma lista de todas as listas de to-do.

Listar todos os to-do's [DEPRECATED]

Esta operação é usada para recuperar todos os to-do's de todas as listas.

Obter um to-do (V2) [DEPRECATED]

Esta ação foi preterida. Em vez disso, utilize Obter um to-do (V3).

Esta operação é usada para obter o to-do com o Id fornecido.

Obter um to-do (V3)

Esta operação é usada para obter o to-do com o Id fornecido.

Obter um to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, utilize Obter um to-do (V3).

Esta operação é usada para obter o to-Do com o Id fornecido.

Obter uma lista de to-do (V2)

Esta operação é usada para obter uma lista de to-do específica.

Obter uma lista de to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Obter uma lista de to-do (V2).

Esta operação é usada para obter uma lista de to-do específica.

Suprimir to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Excluir to-do (V2).

Esta operação é usada para excluir uma tarefa.

Adicionar um to-do (V2) [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Adicionar um to-do (V3).

Esta operação é usada para criar um to-do na lista de to-do especificada (o padrão é To-Do).

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId string

Lista de tarefas pendentes

Data Para Conclusão
DateTime date-time

AAAA-MM-DD ou AAAA-MM-DDThh:mm:ssZ (observe que a parte de tempo será ignorada)

Lembrete Date-Time
DateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Data de início
DateTime date-time

AAAA-MM-DD ou AAAA-MM-DDThh:mm:ssZ (observe que a parte de tempo será ignorada)

Importância
Importance string

Baixa, normal ou alta.

Assunto
Subject True string

Breve descrição ou título do to-do.

Situação
Status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Sensibilidade
Sensitivity string

Indica o nível de privacidade do evento.

Content
Content html

O conteúdo.

Categorias
Categories array of string

Coleção de nomes de categoria associados ao to-do.

É Lembrete em
IsReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Devoluções

Um objeto Microsoft To-Do.

Body
ToDoHtml

Adicionar um to-do (V3)

Esta operação é usada para criar um to-do na lista de to-do especificada.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Data Para Conclusão
dateTime date-time

AAAA-MM-DDThh:mm:ss

Lembrete Date-Time
dateTime date-time

AAAA-MM-DDThh:mm:ss

Importância
importance string

Baixa, normal ou alta.

Title
title True string

Breve descrição ou título do to-do.

Situação
status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Content
content html

O conteúdo do item.

É Lembrete em
isReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo_V2

Adicionar um to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Adicionar um to-do (V3).

Esta operação é usada para criar um to-do na lista de to-do especificada (o padrão é To-Do).

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId string

Lista de tarefas pendentes

Data Para Conclusão
DateTime date-time

AAAA-MM-DD ou AAAA-MM-DDThh:mm:ssZ (observe que a parte de tempo será ignorada)

Lembrete Date-Time
DateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Data de início
DateTime date-time

AAAA-MM-DD ou AAAA-MM-DDThh:mm:ssZ (observe que a parte de tempo será ignorada)

Importância
Importance string

Baixa, normal ou alta.

Assunto
Subject True string

Breve descrição ou título do to-do.

Situação
Status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Sensibilidade
Sensitivity string

Indica o nível de privacidade do evento.

Tipo de conteúdo
ContentType string

Texto=0, HTML=1

Content
Content string

O texto ou conteúdo HTML.

Categorias
Categories array of string

Coleção de nomes de categoria associados ao to-do.

É Lembrete em
IsReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Atualizar uma lista de to-do

Esta operação é usada para atualizar uma lista de to-do específica.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Nome
displayName True string

Nome da lista

Devoluções

Uma lista de To-Do da Microsoft.

Atualização to-do (V2)

Esta operação é usada para atualizar um to-doespecífico.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Tarefa a fazer
id True string

Tarefa a fazer

Data Para Conclusão
dateTime date-time

AAAA-MM-DDThh:mm:ss

Lembrete Date-Time
dateTime date-time

AAAA-MM-DDThh:mm:ss

Importância
importance string

Baixa, normal ou alta.

Title
title string

Breve descrição ou título do to-do.

Situação
status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Content
content html

O conteúdo do item.

É Lembrete em
isReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo_V2

Atualização to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use o Update to-do (V2).

Esta operação é usada para atualizar um to-doespecífico.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Tarefa a fazer
id True string

Tarefa a fazer

Data Para Conclusão
DateTime date-time

AAAA-MM-DD ou AAAA-MM-DDThh:mm:ssZ (observe que a parte de tempo será ignorada)

Lembrete Date-Time
DateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Data de início
DateTime date-time

AAAA-MM-DD ou AAAA-MM-DDThh:mm:ssZ (observe que a parte de tempo será ignorada)

Importância
Importance string

Baixa, normal ou alta.

Assunto
Subject string

Breve descrição ou título do to-do.

Situação
Status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Sensibilidade
Sensitivity string

Indica o nível de privacidade do evento.

Tipo de conteúdo
ContentType string

Texto=0, HTML=1

Content
Content string

O texto ou conteúdo HTML.

Categorias
Categories array of string

Coleção de nomes de categoria associados ao to-do.

É Lembrete em
IsReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Criar uma lista de to-do (V2)

Esta operação é usada para criar uma nova lista de to-do.

Parâmetros

Name Chave Necessário Tipo Description
Nome
displayName True string

Nome da lista

Devoluções

Uma lista de To-Do da Microsoft.

Criar uma lista de to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Criar uma lista de to-do (V2).

Esta operação é usada para criar uma nova lista de to-do.

Parâmetros

Name Chave Necessário Tipo Description
Nome
name True string

Nome da lista

Devoluções

Uma lista de To-Do da Microsoft.

Body
TodoList

Excluir to-do (V2)

Esta operação é usada para excluir uma tarefa.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Tarefa a fazer
id True string

Tarefa a fazer

Excluir uma lista de to-do

Esta operação é usada para excluir uma lista de to-do específica.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Listar to-dopor pasta (V2)

Esta operação é usada para recuperar todos os to-dode uma lista específica.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Contagem superior
$top integer

Número total de entradas a recuperar (padrão = 10, máximo = 999).

Devoluções

response
array of ToDo_V2

Listar to-dopor pasta [DEPRECATED]

Esta ação foi preterida. Em vez disso, use List to-do's by folder (V2).

Esta operação é usada para recuperar todos os to-dode uma lista específica.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Contagem superior
$top integer

Número total de entradas a recuperar (padrão = 10, máximo = 999).

Devoluções

response
array of ToDo

Listar todas as listas de to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Listar todas as to-do listas (V2).

Retorna uma lista de todas as listas de to-do.

Devoluções

Listar todas as listas to-do (V2)

Retorna uma lista de todas as listas de to-do.

Devoluções

Listar todos os to-do's [DEPRECATED]

Esta operação é usada para recuperar todos os to-do's de todas as listas.

Parâmetros

Name Chave Necessário Tipo Description
Contagem superior
$top integer

Número total de entradas a recuperar (padrão = 10, máximo = 999).

Devoluções

response
array of ToDo

Obter um to-do (V2) [DEPRECATED]

Esta ação foi preterida. Em vez disso, utilize Obter um to-do (V3).

Esta operação é usada para obter o to-do com o Id fornecido.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Tarefa a fazer
id True string

Tarefa a fazer

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Obter um to-do (V3)

Esta operação é usada para obter o to-do com o Id fornecido.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Tarefa a fazer
id True string

Tarefa a fazer

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo_V2

Obter um to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, utilize Obter um to-do (V3).

Esta operação é usada para obter o to-Do com o Id fornecido.

Parâmetros

Name Chave Necessário Tipo Description
Identificação de tarefas pendentes
id True string

Identificação de tarefas pendentes

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Obter uma lista de to-do (V2)

Esta operação é usada para obter uma lista de to-do específica.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Devoluções

Uma lista de To-Do da Microsoft.

Obter uma lista de to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Obter uma lista de to-do (V2).

Esta operação é usada para obter uma lista de to-do específica.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
id True string

Lista de tarefas pendentes

Devoluções

Uma lista de To-Do da Microsoft.

Body
TodoList

Suprimir to-do [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Excluir to-do (V2).

Esta operação é usada para excluir uma tarefa.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Tarefa a fazer
id True string

Tarefa a fazer

Acionadores

Quando um novo to-do em uma pasta específica é criado (V2)

Aciona quando um novo to-do em uma pasta específica é criado.

Quando um novo to-do em uma pasta específica é criado [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Quando um novo to-do em uma pasta específica é criado (V2).

Aciona quando um novo to-do em uma pasta específica é criado.

Quando um novo to-do é criado [DEPRECATED]

Aciona quando um novo to-do é criado.

Quando um to-do em uma pasta específica é atualizado (V2)

Aciona quando um to-do em uma pasta específica é atualizado.

Quando um to-do em uma pasta específica é atualizado [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Quando um to-do em uma pasta específica é atualizado (V2).

Aciona quando um to-do em uma pasta específica é atualizado.

Quando um to-do é atualizado [DEPRECATED]

Aciona quando um to-do é atualizado.

Quando um novo to-do em uma pasta específica é criado (V2)

Aciona quando um novo to-do em uma pasta específica é criado.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo_V2

Quando um novo to-do em uma pasta específica é criado [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Quando um novo to-do em uma pasta específica é criado (V2).

Aciona quando um novo to-do em uma pasta específica é criado.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Quando um novo to-do é criado [DEPRECATED]

Aciona quando um novo to-do é criado.

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Quando um to-do em uma pasta específica é atualizado (V2)

Aciona quando um to-do em uma pasta específica é atualizado.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo_V2

Quando um to-do em uma pasta específica é atualizado [DEPRECATED]

Esta ação foi preterida. Em vez disso, use Quando um to-do em uma pasta específica é atualizado (V2).

Aciona quando um to-do em uma pasta específica é atualizado.

Parâmetros

Name Chave Necessário Tipo Description
Lista de Tarefas
folderId True string

Lista de tarefas pendentes

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Quando um to-do é atualizado [DEPRECATED]

Aciona quando um to-do é atualizado.

Devoluções

Um objeto Microsoft To-Do.

Body
ToDo

Definições

Tarefas a fazer

Um objeto Microsoft To-Do.

Name Caminho Tipo Description
Id
id string

Identificador único do to-do.

Criado Date-Time
createdDateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Modificado Date-Time
lastModifiedDateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Categorias
categories array of string

Coleção de nomes de categoria associados ao to-do.

Atribuído A
assignedTo string

Nome da pessoa a quem foi atribuído o to-do.

Tipo de conteúdo
body.contentType string

Texto=0, HTML=1

Content
body.content string

O texto ou conteúdo HTML.

Date-Time
completedDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Date
dueDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Importância
importance string

Baixa, normal ou alta.

É lembrete em
isReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Proprietário
owner string

Nome da pessoa que criou o to-do.

Identificador da pasta pai
parentFolderId string

Identificador exclusivo da pasta pai.

Date-Time
reminderDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Date
startDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Situação
status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Assunto
subject string

Breve descrição ou título do to-do.

ToDoHtml

Um objeto Microsoft To-Do.

Name Caminho Tipo Description
Id
id string

Identificador único do to-do.

Criado Date-Time
createdDateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Modificado Date-Time
lastModifiedDateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Categorias
categories array of string

Coleção de nomes de categoria associados ao to-do.

Atribuído A
assignedTo string

Nome da pessoa a quem foi atribuído o to-do.

Content
body.content html

O conteúdo.

Date-Time
completedDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Date
dueDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Importância
importance string

Baixa, normal ou alta.

É lembrete em
isReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Proprietário
owner string

Nome da pessoa que criou o to-do.

Identificador da pasta pai
parentFolderId string

Identificador exclusivo da pasta pai.

Date-Time
reminderDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Date
startDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Situação
status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Assunto
subject string

Breve descrição ou título do to-do.

TodoList

Uma lista de To-Do da Microsoft.

Name Caminho Tipo Description
Id
id string

Identificador exclusivo da lista de to-do.

Nome
name string

Nome da lista de to-do.

É padrão
isDefaultFolder boolean

True se esta for a lista de to-do padrão.

TodoList_V2

Uma lista de To-Do da Microsoft.

Name Caminho Tipo Description
Id
id string

Identificador exclusivo da lista de to-do.

Nome
displayName string

Nome da lista de to-do.

Nome bem conhecido
wellknownListName string

Propriedade que indica o nome da lista bem conhecida se a lista fornecida for uma lista conhecida. Os valores possíveis são: none, defaultList, flaggedEmails, unknownFutureValue.

É proprietário
isOwner boolean

True se o usuário for proprietário da lista de tarefas fornecida.

É partilhado
isShared boolean

True se a lista de tarefas for compartilhada com outros usuários.

ToDo_V2

Um objeto Microsoft To-Do.

Name Caminho Tipo Description
Id
id string

Identificador único do to-do.

Criado Date-Time
createdDateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Modificado Date-Time
lastModifiedDateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Tipo de conteúdo
body.contentType string

O tipo de conteúdo. Os valores possíveis são text e html.

Content
body.content string

O conteúdo do item.

Modificado Date-Time
bodyLastModifiedDateTime date-time

AAAA-MM-DDThh:mm:ssZ (formato UTC)

Date
completedDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ss

Date
dueDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ss

Importância
importance string

Baixa, normal ou alta.

É lembrete em
isReminderOn boolean

True se um alerta estiver definido para lembrar o usuário do to-do.

Date-Time
reminderDateTime.dateTime date-time

AAAA-MM-DDThh:mm:ss

Situação
status string

Indica o estado ou progresso do to-do - não iniciado, em andamento, concluído, aguardando outros ou adiado.

Title
title string

Breve descrição ou título do to-do.