Namespace: microsoft.graph
Erstellen Sie eine neue Schicht instance in einem Zeitplan.
Die Dauer einer Schicht darf nicht kleiner als 1 Minute oder länger als 24 Stunden sein.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service |
US Government L4 |
US Government L5 (DOD) |
China, betrieben von 21Vianet |
✅ |
❌ |
❌ |
❌ |
Berechtigungen
Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.
Berechtigungstyp |
Berechtigungen mit den geringsten Berechtigungen |
Berechtigungen mit höheren Berechtigungen |
Delegiert (Geschäfts-, Schul- oder Unikonto) |
Schedule.ReadWrite.All |
Group.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) |
Nicht unterstützt |
Nicht unterstützt |
Application |
Schedule.ReadWrite.All |
Nicht verfügbar. |
HTTP-Anforderung
POST /teams/{teamId}/schedule/shifts
Kopfzeile |
Wert |
Authorization |
Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Content-Type |
application/json. Erforderlich. |
MS-APP-ACTS-AS (veraltet) |
Eine Benutzer-ID (GUID). Nur erforderlich, wenn das Autorisierungstoken ein Anwendungstoken ist. andernfalls optional. Der MS-APP-ACTS-AS Header ist veraltet und für Anwendungstoken nicht mehr erforderlich. |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung des geänderten Shift-Objekts an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die Sie beim Erstellen eines Umschaltobjekts verwenden können.
Eigenschaft |
Typ |
Beschreibung |
draftShift |
shiftItem |
Entwurfsänderungen in der Schicht. Entwurfsänderungen sind nur für Manager sichtbar. Die Änderungen sind für Mitarbeiter sichtbar, wenn sie freigegeben werden, wodurch die Änderungen aus der draftShift-Eigenschaft in die sharedShift-Eigenschaft kopiert werden. Eiher draShift oder sharedShift sollte sein null . |
isStagedForDeletion |
Boolean |
Die Verschiebung ist zum Löschen markiert, ein Prozess, der abgeschlossen wird, wenn der Zeitplan freigegeben wird. Optional. |
schedulingGroupId |
Zeichenfolge |
ID der Planungsgruppe, zu der die Schicht gehört. Erforderlich. |
sharedShift |
shiftItem |
Die freigegebene Version dieser Schicht , die sowohl für Mitarbeiter als auch für Vorgesetzte sichtbar ist. Updates an die sharedShift-Eigenschaft senden Benachrichtigungen an Benutzer im Teams-Client. Eiher draShift oder sharedShift sollte sein null . |
userId |
String |
ID des Benutzers, der der Schicht zugewiesen ist. Erforderlich. |
Antwort
Bei erfolgreicher Ausführung gibt die Methode einen 201 Created
Antwortcode und ein Shift-Objekt im Antworttext zurück.
Beispiel
Anforderung
Das folgende Beispiel zeigt eine Anfrage.
POST https://graph.microsoft.com/v1.0/teams/{teamId}/schedule/shifts
Content-type: application/json
{
"userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",
"draftShift": {
"displayName": null,
"startDateTime": "2024-10-08T15:00:00Z",
"endDateTime": "2024-10-09T00:00:00Z",
"theme": "blue",
"notes": null,
"activities": []
},
"sharedShift": null,
"isStagedForDeletion": false
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new Shift
{
UserId = "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",
DraftShift = new ShiftItem
{
DisplayName = null,
StartDateTime = DateTimeOffset.Parse("2024-10-08T15:00:00Z"),
EndDateTime = DateTimeOffset.Parse("2024-10-09T00:00:00Z"),
Theme = ScheduleEntityTheme.Blue,
Notes = null,
Activities = new List<ShiftActivity>
{
},
},
SharedShift = null,
IsStagedForDeletion = false,
};
// 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.Shifts.PostAsync(requestBody);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
mgc teams schedule shifts create --team-id {team-id} --body '{\
"userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",\
"draftShift": {\
"displayName": null,\
"startDateTime": "2024-10-08T15:00:00Z",\
"endDateTime": "2024-10-09T00:00:00Z",\
"theme": "blue",\
"notes": null,\
"activities": []\
},\
"sharedShift": null,\
"isStagedForDeletion": false\
}\
'
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// 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.NewShift()
userId := "5ca83ce7-291d-43b7-bf53-af79eef4bc1d"
requestBody.SetUserId(&userId)
draftShift := graphmodels.NewShiftItem()
displayName := null
draftShift.SetDisplayName(&displayName)
startDateTime , err := time.Parse(time.RFC3339, "2024-10-08T15:00:00Z")
draftShift.SetStartDateTime(&startDateTime)
endDateTime , err := time.Parse(time.RFC3339, "2024-10-09T00:00:00Z")
draftShift.SetEndDateTime(&endDateTime)
theme := graphmodels.BLUE_SCHEDULEENTITYTHEME
draftShift.SetTheme(&theme)
notes := null
draftShift.SetNotes(¬es)
activities := []graphmodels.ShiftActivityable {
}
draftShift.SetActivities(activities)
requestBody.SetDraftShift(draftShift)
sharedShift := null
requestBody.SetSharedShift(&sharedShift)
isStagedForDeletion := false
requestBody.SetIsStagedForDeletion(&isStagedForDeletion)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
shifts, err := graphClient.Teams().ByTeamId("team-id").Schedule().Shifts().Post(context.Background(), requestBody, nil)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
Shift shift = new Shift();
shift.setUserId("5ca83ce7-291d-43b7-bf53-af79eef4bc1d");
ShiftItem draftShift = new ShiftItem();
draftShift.setDisplayName(null);
OffsetDateTime startDateTime = OffsetDateTime.parse("2024-10-08T15:00:00Z");
draftShift.setStartDateTime(startDateTime);
OffsetDateTime endDateTime = OffsetDateTime.parse("2024-10-09T00:00:00Z");
draftShift.setEndDateTime(endDateTime);
draftShift.setTheme(ScheduleEntityTheme.Blue);
draftShift.setNotes(null);
LinkedList<ShiftActivity> activities = new LinkedList<ShiftActivity>();
draftShift.setActivities(activities);
shift.setDraftShift(draftShift);
shift.setSharedShift(null);
shift.setIsStagedForDeletion(false);
Shift result = graphClient.teams().byTeamId("{team-id}").schedule().shifts().post(shift);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
const options = {
authProvider,
};
const client = Client.init(options);
const shift = {
userId: '5ca83ce7-291d-43b7-bf53-af79eef4bc1d',
draftShift: {
displayName: null,
startDateTime: '2024-10-08T15:00:00Z',
endDateTime: '2024-10-09T00:00:00Z',
theme: 'blue',
notes: null,
activities: []
},
sharedShift: null,
isStagedForDeletion: false
};
await client.api('/teams/{teamId}/schedule/shifts')
.post(shift);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\Shift;
use Microsoft\Graph\Generated\Models\ShiftItem;
use Microsoft\Graph\Generated\Models\ScheduleEntityTheme;
use Microsoft\Graph\Generated\Models\ShiftActivity;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new Shift();
$requestBody->setUserId('5ca83ce7-291d-43b7-bf53-af79eef4bc1d');
$draftShift = new ShiftItem();
$draftShift->setDisplayName(null);
$draftShift->setStartDateTime(new \DateTime('2024-10-08T15:00:00Z'));
$draftShift->setEndDateTime(new \DateTime('2024-10-09T00:00:00Z'));
$draftShift->setTheme(new ScheduleEntityTheme('blue'));
$draftShift->setNotes(null);
$draftShift->setActivities([ ]);
$requestBody->setDraftShift($draftShift);
$requestBody->setSharedShift(null);
$requestBody->setIsStagedForDeletion(false);
$result = $graphServiceClient->teams()->byTeamId('team-id')->schedule()->shifts()->post($requestBody)->wait();
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
Import-Module Microsoft.Graph.Teams
$params = @{
userId = "5ca83ce7-291d-43b7-bf53-af79eef4bc1d"
draftShift = @{
displayName = $null
startDateTime = [System.DateTime]::Parse("2024-10-08T15:00:00Z")
endDateTime = [System.DateTime]::Parse("2024-10-09T00:00:00Z")
theme = "blue"
notes = $null
activities = @(
)
}
sharedShift = $null
isStagedForDeletion = $false
}
New-MgTeamScheduleShift -TeamId $teamId -BodyParameter $params
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.shift import Shift
from msgraph.generated.models.shift_item import ShiftItem
from msgraph.generated.models.schedule_entity_theme import ScheduleEntityTheme
from msgraph.generated.models.shift_activity import ShiftActivity
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Shift(
user_id = "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",
draft_shift = ShiftItem(
display_name = None,
start_date_time = "2024-10-08T15:00:00Z",
end_date_time = "2024-10-09T00:00:00Z",
theme = ScheduleEntityTheme.Blue,
notes = None,
activities = [
],
),
shared_shift = None,
is_staged_for_deletion = False,
)
result = await graph_client.teams.by_team_id('team-id').schedule.shifts.post(request_body)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 201 Created
Content-type: application/json
{
"id": "SHFT_0f004eda-32a6-4f0c-a076-18f76d997a55",
"createdDateTime": "2024-11-08T23:49:13.877Z",
"lastModifiedDateTime": "2024-11-08T23:49:13.877Z",
"schedulingGroupId": "TAG_4ab7d329-1f7e-4eaf-ba93-63f1ff3f3c4a",
"userId": "5ca83ce7-291d-43b7-bf53-af79eef4bc1d",
"sharedShift": null,
"lastModifiedBy": {
"application": null,
"device": null,
"user": {
"id": "366c0b19-49b1-41b5-a03f-9f3887bd0ed8",
"displayName": "John Doe",
"userIdentityType": "aadUser",
"tenantId": null
}
},
"draftShift": {
"displayName": null,
"startDateTime": "2024-10-08T15:00:00Z",
"endDateTime": "2024-10-09T00:00:00Z",
"theme": "blue",
"notes": null,
"activities": []
},
"isStagedForDeletion": false
}