Zeitplan: Freigebenschedule: share

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Freigeben eines Zeitbereichs für den Zeitplan mit Schedule-Mitgliedern.Share a schedule time range with schedule members. Stellen Sie die Auflistungen von Schicht -und timeOff -Elementen im angegebenen Zeitbereich des Zeitplans dar, der von den angegebenen Teammitgliedern angezeigt wird, einschließlich Mitarbeitern und Managern.Make the collections of shift and timeOff items in the specified time range of the schedule viewable by the specified team members, including employees and managers. Jede Schicht -und timeOff -Instanz in einem Zeitplan unterstützt eine Entwurfsversion und eine freigegebene Version des Elements.Each shift and timeOff instance in a schedule supports a draft version and a shared version of the item. Die Entwurfsversion kann nur von Managern angezeigt werden, und die freigegebene Version kann von Mitarbeitern und Managern angezeigt werden.The draft version is viewable by only managers, and the shared version is viewable by employees and managers. Für jede Schicht -und timeOff -Instanz im angegebenen Zeitbereich aktualisiert die Freigabe Aktion die freigegebene Version aus der Entwurfsversion, sodass Mitarbeiter neben Managern auch die aktuellsten Informationen zum Element anzeigen können.For each shift and timeOff instance in the specified time range, the share action updates the shared version from the draft version, so that in addition to managers, employees can also view the most current information about the item. Der Parameter notifyTeam gibt weiter an, welche Mitarbeiter das Element anzeigen können.The notifyTeam parameter further specifies which employees can view the item.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Group.ReadWrite.AllGroup.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

Hinweis: Diese API unterstützt Administratorberechtigungen.Note: This API supports admin permissions. Globale Administratoren können auf Gruppen zugreifen, bei denen Sie kein Mitglied sind.Global admins can access groups that they are not a member of.

HTTP-AnforderungHTTP request

POST /teams/{teamId}/schedule/share

AnforderungsheaderRequest headers

KopfzeileHeader WertValue
AuthorizationAuthorization Bearer {token}. Erforderlich.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.In the request body, provide a JSON object with the following parameters.

ParameterParameter TypType BeschreibungDescription
notifyTeamnotifyTeam Boolean Gibt an, ob das gesamte Team eine sichtbare Benachrichtigung über diese Aktion erhalten soll oder nur Mitarbeiter, denen eine Schicht zugewiesen wurde, die freigegeben wurde.Indicates whether the entire team should get a visible notification of this action, or only employees that have a shift assigned to them that was shared. Erforderlich.Required.
startDateTimestartDateTime DateTimeOffset Die Startzeit für die Freigabe von Schicht Verschiebungen aus dem Zeitplan.The start time to share shifts on the schedule from. Erforderlich.Required.
endDateTimeendDateTime DateTimeOffset Die Endzeit zum Freigeben von Verschiebungen für den Zeitplan bis.The end time to share shifts on the schedule until.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben. Im Antworttext wird nichts zurückgegeben.If successful, this method returns a 204 No Content response code. It does not return anything in the response body.

BeispielExample

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.The following is an example of the request.

POST https://graph.microsoft.com/beta/teams/{teamId}/schedule/share
Content-type: application/json

{
  "notifyTeam": true,
  "startDateTime": "2018-10-08T00:00:00.000Z",
  "endDateTime": "2018-10-15T00:00:00.000Z"
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 204 No content