tipo de recurso outlookTask (substituído)
Namespace: microsoft.graph
Importante
As APIs na versão /beta
no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Cuidado
A API de tarefas do Outlook está depreciada e deixará de retornar dados em 20 de agosto de 2022. Por favor, use o novo To Do API. Para saber mais, confira APIs de Tarefas Pendentes na visualização pública.
Um item do Outlook que pode acompanhar um item de trabalho.
Você pode usar uma tarefa para controlar as datas e horas de conclusão atuais ou anteriores, seu andamento ou status, se são recorrentes ou requerem um lembrete.
As propriedades relacionadas à data no recurso outlookTask incluem o seguinte:
- completedDateTime
- createdDateTime
- dueDateTime
- lastModifiedDateTime
- reminderDateTime
- startDateTime
Por padrão, as operações POST, GET, PATCH e complete retornam as propriedades relacionadas à data em suas respostas REST em UTC.
Você pode usar o Prefer: outlook.timezone
cabeçalho para que todas as propriedades relacionadas às datas como resposta representada em um fuso horário diferente do UTC. O exemplo a seguir retorna propriedades de data no EST na resposta correspondente:
Prefer: outlook.timezone="Eastern Standard Time"
Métodos
Método | Tipo de retorno | Descrição |
---|---|---|
Obter outlookTask | outlookTask | Obtenha as propriedades e as relações de uma tarefa do Outlook na caixa de correio do usuário. |
Atualizar | outlookTask | Altere as propriedades graváveis de uma tarefa do Outlook. |
Excluir | Nenhum | Exclua a tarefa especificada na caixa de correio do usuário. |
Concluído | coleção outlookTask | Concluir uma tarefa do Outlook que define a propriedadecompletedDateTime para a data atual e a propriedade destatus para completed . |
Anexos | ||
List attachments | Coleção anexo | Obtenha todos os anexos de uma tarefa do Outlook. |
Add attachment | anexo | Adiciona um arquivo, um item (mensagem, evento ou contato) ou um link a um arquivo como um anexo a uma tarefa. |
Propriedades estendidas | ||
Criar uma propriedade estendida de valor único | outlookTask | Criar uma ou mais propriedades estendidas de valor único em uma tarefa do Outlook nova ou existente. |
Obter tarefa com propriedade estendida de valor único | outlookTask | Obter tarefas do Outlook que contenham uma propriedade estendida de valor único usando $expand ou $filter . |
Criar propriedade estendida de vários valores | outlookTask | Criar uma ou mais propriedades estendidas de vários valores em uma tarefa do Outlook nova ou existente. |
Obter postagem com propriedade estendida de vários valores | outlookTask | Obter uma tarefa do Outlook que contenha uma propriedade estendida de vários valores usando $expand . |
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
assignedTo | String | O nome da pessoa a qual foi atribuída a tarefa no Outlook. Somente leitura. |
corpo | itemBody | Corpo da tarefa que normalmente contém informações sobre a tarefa. Observe para qual tipo de HTML há suporte. |
Categorias | Coleção de cadeias de caracteres | As categorias associadas à postagem. Cada categoria corresponde à propriedade displayName de uma outlookCategory definida pelo usuário. |
changeKey | Cadeia de caracteres | A versão da tarefa. |
completedDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa foi concluída. |
createdDateTime | DateTimeOffset | A data e a hora da criação da tarefa. Por padrão, está definida em UTC. Você pode fornecer um fuso horário personalizado no cabeçalho da solicitação. O valor da propriedade usa o formato ISO 8601. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . |
dueDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa será concluída. |
hasAttachments | Booliano | Defina como verdadeiro se a tarefa tiver anexos. |
id | Cadeia de caracteres | Identificador exclusivo para a tarefa. Por padrão, esse valor muda quando o item é transferido de um contêiner (como uma pasta ou calendário) para outro. Para alterar esse comportamento, use o cabeçalho Prefer: IdType="ImmutableId" . Para obter mais informações, consulte o artigo Obter identificadores imutáveis para recursos do Outlook. Somente leitura. |
importância | importância | A importância do evento. Os valores possíveis são: low , normal , high . |
isReminderOn | Booliano | Definido como verdadeiro se um alerta é definido para lembrar o usuário da tarefa. |
lastModifiedDateTime | DateTimeOffset | A data e hora da última modificação da tarefa. Por padrão, está definida em UTC. Você pode fornecer um fuso horário personalizado no cabeçalho da solicitação. O valor da propriedade usa o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z . |
owner | Cadeia de caracteres | O nome da pessoa que criou a tarefa. |
parentFolderId | Cadeia de caracteres | O identificador exclusivo para a pasta pai da tarefa. |
recorrência | patternedRecurrence | O padrão de recorrência da tarefa. |
reminderDateTime | dateTimeTimeZone | A data e hora do alerta de lembrete da tarefa. |
sensibilidade | sensibilidade | Indica o nível de privacidade da tarefa. Os valores possíveis são: normal , personal , private , confidential . |
startDateTime | dateTimeTimeZone | A data no fuso horário especificado que a tarefa será iniciada. |
status | taskStatus | Indica o estado ou o andamento da tarefa. Os valores possíveis são: notStarted , inProgress , completed , waitingOnOthers , deferred . |
assunto | Cadeia de caracteres | Uma breve descrição ou o título da tarefa. |
Relações
Relação | Tipo | Descrição |
---|---|---|
attachments | Coleção anexo | A coleção de anexos FileAttachment, ItemAttachment e referenceAttachment da tarefa. Somente leitura. Anulável. |
multiValueExtendedProperties | Coleção multiValueLegacyExtendedProperty | A coleção de propriedades estendidas de vários valores definidas para a tarefa. Somente leitura. Anulável. |
singleValueExtendedProperties | Coleção singleValueLegacyExtendedProperty | A coleção de propriedades estendidas de valor único definidas para a tarefa. Somente leitura. Anulável. |
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
{
"assignedTo": "String",
"body": {"@odata.type": "microsoft.graph.itemBody"},
"categories": ["String"],
"changeKey": "String",
"completedDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"createdDateTime": "String (timestamp)",
"dueDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"hasAttachments": true,
"id": "String (identifier)",
"importance": "string",
"isReminderOn": true,
"lastModifiedDateTime": "String (timestamp)",
"owner": "String",
"parentFolderId": "String",
"recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
"reminderDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"sensitivity": "string",
"startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
"status": "string",
"subject": "String"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de