Namespace: microsoft.graph
Crie uma instância timeCard numa agenda.
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.ReadWrite.All |
Indisponível. |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
Schedule.ReadWrite.All |
Indisponível. |
Solicitação HTTP
POST /teams/{teamsId}/schedule/timeCards
| Cabeçalho |
Valor |
| Autorização |
{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-type |
application/json. Obrigatório. |
| MS-APP-ACTS-AS (preterido) |
Um ID de utilizador (GUID). Necessário apenas se o token de autorização for um token de aplicação; caso contrário, opcional. O MS-APP-ACTS-AS cabeçalho foi preterido e já não é necessário com tokens de aplicação. |
Corpo da solicitação
Indique o novo objeto timeCard no corpo do pedido para este método.
Resposta
Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto timeCard no corpo da resposta.
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/v1.0/teams/871dbd5c-3a6a-4392-bfe1-042452793a50/schedule/timeCards
Content-Type: application/json
{
"userId": "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2",
"clockInEvent": {
"dateTime": "2025-01-07T21:00:00.000Z",
"isAtApprovedLocation": true,
"notes": {
"content": "Started late due to traffic in CA 237",
"contentType": "text"
}
},
"clockOutEvent": {
"dateTime": "2025-01-07T21:30:00.000Z",
"isAtApprovedLocation": true
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new TimeCard
{
UserId = "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2",
ClockInEvent = new TimeCardEvent
{
DateTime = DateTimeOffset.Parse("2025-01-07T21:00:00.000Z"),
IsAtApprovedLocation = true,
Notes = new ItemBody
{
Content = "Started late due to traffic in CA 237",
ContentType = BodyType.Text,
},
},
ClockOutEvent = new TimeCardEvent
{
DateTime = DateTimeOffset.Parse("2025-01-07T21:30:00.000Z"),
IsAtApprovedLocation = true,
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Schedule.TimeCards.PostAsync(requestBody);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest major version. Current major version is $v1.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewTimeCard()
userId := "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2"
requestBody.SetUserId(&userId)
clockInEvent := graphmodels.NewTimeCardEvent()
dateTime , err := time.Parse(time.RFC3339, "2025-01-07T21:00:00.000Z")
clockInEvent.SetDateTime(&dateTime)
isAtApprovedLocation := true
clockInEvent.SetIsAtApprovedLocation(&isAtApprovedLocation)
notes := graphmodels.NewItemBody()
content := "Started late due to traffic in CA 237"
notes.SetContent(&content)
contentType := graphmodels.TEXT_BODYTYPE
notes.SetContentType(&contentType)
clockInEvent.SetNotes(notes)
requestBody.SetClockInEvent(clockInEvent)
clockOutEvent := graphmodels.NewTimeCardEvent()
dateTime , err := time.Parse(time.RFC3339, "2025-01-07T21:30:00.000Z")
clockOutEvent.SetDateTime(&dateTime)
isAtApprovedLocation := true
clockOutEvent.SetIsAtApprovedLocation(&isAtApprovedLocation)
requestBody.SetClockOutEvent(clockOutEvent)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
timeCards, err := graphClient.Teams().ByTeamId("team-id").Schedule().TimeCards().Post(context.Background(), requestBody, nil)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
TimeCard timeCard = new TimeCard();
timeCard.setUserId("d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2");
TimeCardEvent clockInEvent = new TimeCardEvent();
OffsetDateTime dateTime = OffsetDateTime.parse("2025-01-07T21:00:00.000Z");
clockInEvent.setDateTime(dateTime);
clockInEvent.setIsAtApprovedLocation(true);
ItemBody notes = new ItemBody();
notes.setContent("Started late due to traffic in CA 237");
notes.setContentType(BodyType.Text);
clockInEvent.setNotes(notes);
timeCard.setClockInEvent(clockInEvent);
TimeCardEvent clockOutEvent = new TimeCardEvent();
OffsetDateTime dateTime1 = OffsetDateTime.parse("2025-01-07T21:30:00.000Z");
clockOutEvent.setDateTime(dateTime1);
clockOutEvent.setIsAtApprovedLocation(true);
timeCard.setClockOutEvent(clockOutEvent);
TimeCard result = graphClient.teams().byTeamId("{team-id}").schedule().timeCards().post(timeCard);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
const options = {
authProvider,
};
const client = Client.init(options);
const timeCard = {
userId: 'd56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2',
clockInEvent: {
dateTime: '2025-01-07T21:00:00.000Z',
isAtApprovedLocation: true,
notes: {
content: 'Started late due to traffic in CA 237',
contentType: 'text'
}
},
clockOutEvent: {
dateTime: '2025-01-07T21:30:00.000Z',
isAtApprovedLocation: true
}
};
await client.api('/teams/871dbd5c-3a6a-4392-bfe1-042452793a50/schedule/timeCards')
.post(timeCard);
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\TimeCard;
use Microsoft\Graph\Generated\Models\TimeCardEvent;
use Microsoft\Graph\Generated\Models\ItemBody;
use Microsoft\Graph\Generated\Models\BodyType;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new TimeCard();
$requestBody->setUserId('d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2');
$clockInEvent = new TimeCardEvent();
$clockInEvent->setDateTime(new \DateTime('2025-01-07T21:00:00.000Z'));
$clockInEvent->setIsAtApprovedLocation(true);
$clockInEventNotes = new ItemBody();
$clockInEventNotes->setContent('Started late due to traffic in CA 237');
$clockInEventNotes->setContentType(new BodyType('text'));
$clockInEvent->setNotes($clockInEventNotes);
$requestBody->setClockInEvent($clockInEvent);
$clockOutEvent = new TimeCardEvent();
$clockOutEvent->setDateTime(new \DateTime('2025-01-07T21:30:00.000Z'));
$clockOutEvent->setIsAtApprovedLocation(true);
$requestBody->setClockOutEvent($clockOutEvent);
$result = $graphServiceClient->teams()->byTeamId('team-id')->schedule()->timeCards()->post($requestBody)->wait();
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
Import-Module Microsoft.Graph.Teams
$params = @{
userId = "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2"
clockInEvent = @{
dateTime = [System.DateTime]::Parse("2025-01-07T21:00:00.000Z")
isAtApprovedLocation = $true
notes = @{
content = "Started late due to traffic in CA 237"
contentType = "text"
}
}
clockOutEvent = @{
dateTime = [System.DateTime]::Parse("2025-01-07T21:30:00.000Z")
isAtApprovedLocation = $true
}
}
New-MgTeamScheduleTimeCard -TeamId $teamId -BodyParameter $params
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.time_card import TimeCard
from msgraph.generated.models.time_card_event import TimeCardEvent
from msgraph.generated.models.item_body import ItemBody
from msgraph.generated.models.body_type import BodyType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = TimeCard(
user_id = "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2",
clock_in_event = TimeCardEvent(
date_time = "2025-01-07T21:00:00.000Z",
is_at_approved_location = True,
notes = ItemBody(
content = "Started late due to traffic in CA 237",
content_type = BodyType.Text,
),
),
clock_out_event = TimeCardEvent(
date_time = "2025-01-07T21:30:00.000Z",
is_at_approved_location = True,
),
)
result = await graph_client.teams.by_team_id('team-id').schedule.time_cards.post(request_body)
Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "TCK_18aeaf79-71c3-44a5-8a6c-236d25d0f726",
"createdDateTime": "2025-01-07T21:30:20.487Z",
"lastModifiedDateTime": "2025-01-07T21:30:20.487Z",
"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-07T21:00:00Z",
"isAtApprovedLocation": true,
"notes": {
"contentType": "text",
"content": "Started late due to traffic in CA 237"
}
},
"clockOutEvent": {
"dateTime": "2025-01-07T21:30:00Z",
"isAtApprovedLocation": true,
"notes": null
},
"breaks": [],
"originalEntry": {
"clockInEvent": null,
"clockOutEvent": null,
"breaks": []
},
"createdBy": {
"application": null,
"device": null,
"user": {
"id": "d56f3e8a-2b0f-42b1-88b9-e2dbd12a34d2",
"displayName": "Alice Bradford"
}
}
}