Obter timeCard
Namespace: microsoft.graph
Leia as propriedades e relações de um objeto timeCard .
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Schedule.Read.All | Schedule.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | Schedule.Read.All | Schedule.ReadWrite.All |
Importante
Quando utiliza as permissões de aplicação Schedule.Read.All e Schedule.ReadWrite.All, tem de incluir o MS-APP-ACTS-AS cabeçalho no pedido.
Solicitação HTTP
GET /teams/{teamsId}/schedule/timeCards/{timeCardId}
Parâmetros de consulta opcionais
Este método não suporta parâmetros de consulta OData para personalizar a resposta.
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| MS-APP-ACTS-AS | O ID do utilizador em nome do qual a aplicação está a agir. Necessário quando utiliza o âmbito de permissão da aplicação. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto timeCard no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/teams/fd15cad8-80f6-484f-9666-3caf695fbf32/schedule/timeCards/TCK_3e74d9a1-f45f-4da3-95df-be72a8af448d
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
{
"id": "TCK_3e74d9a1-f45f-4da3-95df-be72a8af448d",
"createdDateTime": "2025-01-08T15:44:09.545Z",
"lastModifiedDateTime": "2025-01-08T19:45:25.048Z",
"userId": "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2",
"state": "clockedOut",
"confirmedBy": "none",
"notes": null,
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2",
"displayName": "Alice Bradford",
}
},
"clockInEvent": {
"dateTime": "2025-01-08T15:44:09.545Z",
"isAtApprovedLocation": null,
"notes": null
},
"clockOutEvent": {
"dateTime": "2025-01-07T19:45:25.048Z",
"isAtApprovedLocation": null,
"notes": null
},
"breaks": [],
"originalEntry": {
"clockInEvent": {
"dateTime": "2025-01-07T15:44:09.545Z",
"isAtApprovedLocation": null,
"notes": null
},
"clockOutEvent": {
"dateTime": "2025-01-07T19:45:25.048Z",
"isAtApprovedLocation": null,
"notes": null
},
"breaks": []
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2",
"displayName": "Alice Bradford",
}
}
}