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 foi preterida e deixou de devolver dados a 20 de agosto de 2022. Em alternativa, utilize a API To Do .
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 |
---|---|---|
Get | 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 de valor único | outlookTask | Criar uma ou mais propriedades estendidas de valor único em uma tarefa do Outlook nova ou existente. |
Obter uma propriedade de valor único | outlookTask | Obter tarefas do Outlook que contenham uma propriedade estendida de valor único usando $expand ou $filter . |
Criar propriedade com múltiplos valores | outlookTask | Criar uma ou mais propriedades estendidas de vários valores em uma tarefa do Outlook nova ou existente. |
Obter propriedade de múltiplos 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 seguinte 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