Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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.
Obtenha o histórico de alterações feitas nas tarefas dentro de um plano.
Disponibilidade da API
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Tasks.Read | Tasks.ReadWrite |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | Tasks.Read.All | Tasks.ReadWrite.All |
Solicitação HTTP
GET /planner/plans/{plan-id}/historyItems
Parâmetros de consulta opcionais
Esse método dá suporte $filter ao parâmetro de consulta OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
Use $filter na propriedade occurredDateTime para recuperar itens do histórico em um intervalo de tempo específico.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK código de resposta e uma coleção de objetos plannerHistoryItem no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra como obter itens do histórico de tarefas para um plano com um filtro de data.
GET https://graph.microsoft.com/beta/planner/plans/nETqF5FS2LkCp935s-FIFm2QAFkHM/historyItems?$filter=occurredDateTime gt 2025-11-01T00:00:00Z and occurredDateTime lt 2025-12-01T00:00:00Z
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#planner/plans('nETqF5FS2LkCp935s-FIFm2QAFkHM')/historyItems",
"value": [
{
"@odata.type": "#microsoft.graph.taskHistoryItem",
"id": "historyItem-id-1",
"planId": "nETqF5FS2LkCp935s-FIFm2QAFkHM",
"entityId": "dYsWHy7-WEGMQsMaPBv_9ZUAOzQz",
"entityType": "task",
"eventType": "created",
"occurredDateTime": "2026-01-12T14:16:26.5896957Z",
"actor": {
"user": {
"displayName": null,
"id": "6699294c-9300-4ad8-a768-af3407b5e0fe"
},
"application": {
"displayName": null,
"id": "09abbdfd-ed23-44ee-a2d9-a627a41c90f3"
}
},
"oldData": null,
"newData": {
"createdBy": {
"user": {
"displayName": null,
"id": "6699294c-9300-4ad8-a768-af3407b5e0fe"
},
"application": {
"displayName": null,
"id": "09abbdfd-ed23-44ee-a2d9-a627a41c90f3"
}
},
"bucketId": "0LHuWF3PrUqKYzq-TcR3oJUADFn8",
"isArchived": false,
"title": "Initial Task Title",
"orderHint": "8584333795589189673P,",
"percentComplete": 0,
"priority": 5
}
},
{
"@odata.type": "#microsoft.graph.taskHistoryItem",
"id": "historyItem-id-2",
"planId": "nETqF5FS2LkCp935s-FIFm2QAFkHM",
"entityId": "dYsWHy7-WEGMQsMaPBv_9ZUAOzQz",
"entityType": "task",
"eventType": "updated",
"occurredDateTime": "2026-01-12T15:16:26.5896957Z",
"actor": {
"user": {
"displayName": null,
"id": "6699294c-9300-4ad8-a768-af3407b5e0fe"
},
"application": {
"displayName": null,
"id": "09abbdfd-ed23-44ee-a2d9-a627a41c90f3"
}
},
"oldData": {
"title": "Initial Task Title",
"percentComplete": 0
},
"newData": {
"title": "Updated Task Title",
"percentComplete": 50
}
}
]
}