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.
Pode utilizar uma tarefa para controlar:
- As datas e horas de início, conclusão e conclusão reais.
- O progresso ou o estado da tarefa.
- Os estados de periodicidade e lembrete da tarefa.
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. |
| Excluir permanentemente | Nenhum | Elimine permanentemente uma tarefa do Outlook e coloque-a na pasta Remoção na pasta Itens Recuperáveis na caixa de correio do utilizador. |
| Concluído | coleção outlookTask | Conclua uma tarefa do Outlook que define a propriedade completedDateTime como a data atual e a propriedade de estado como 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. Apenas o tipo html é suportado. |
| categories | 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"
}