Kalender aktualisierenUpdate calendar

Namespace: microsoft.graphNamespace: microsoft.graph

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.

Mit dieser API können Sie die Eigenschaften eines calendar-Objekts aktualisieren.Update the properties of a calendar object. Dies kann ein Kalender für einen Benutzer oder der Standardkalender einer Office 365-Gruppe sein.The calendar can be one for a user, or the default calendar of an Office 365 group.

BerechtigungenPermissions

Je nach dem Typ des Kalenders, in dem sich das Ereignis befindet, und dem Typ der Berechtigung (delegierte Berechtigung oder Anwendungsberechtigung), ist eine der folgenden Berechtigungen erforderlich, um diese API aufzurufen.Depending on the type of calendar that the event is in and the permission type (delegated or application) requested, one of the following permissions is required to call this API. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.To learn more, including how to choose permissions, see Permissions.

KalenderCalendar Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) ApplicationApplication
Benutzerkalenderuser calendar Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite Calendars.ReadWriteCalendars.ReadWrite
Gruppenkalendergroup calendar Group.ReadWrite.AllGroup.ReadWrite.All Nicht unterstütztNot supported. Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

Der Standardkalender eines Benutzers oder einer Gruppe.A user's or group's default calendar.

PATCH /me/calendar
PATCH /users/{id | userPrincipalName}/calendar
PATCH /groups/{id}/calendar

Der Kalender eines Benutzers in der standardmäßigen CalendarGroup.A user's calendar in the default calendarGroup.

PATCH /me/calendars/{id}
PATCH /users/{id | userPrincipalName}/calendars/{id}

PATCH /me/calendarGroup/calendars/{id}
PATCH /users/{id | userPrincipalName}/calendarGroup/calendars/{id}

Der Kalender eines Benutzers in einer bestimmten CalendarGroup.A user's calendar in a specific calendarGroup.

PATCH /me/calendarGroups/{id}/calendars/{id}
PATCH /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}

AnforderungsheaderRequest headers

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

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
colorcolor StringString Gibt das Farbdesign an, um den Kalender von anderen Kalendern in einer Benutzeroberfläche zu unterscheiden. Die Eigenschaftswerte sind: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: LightBlue=0, LightGreen=1, LightOrange=2, LightGray=3, LightYellow=4, LightTeal=5, LightPink=6, LightBrown=7, LightRed=8, MaxColor=9, Auto=-1
isDefaultCalendarisDefaultCalendar Boolescher WertBoolean „True“, wenn der Kalender der Standardkalender des Benutzers ist, andernfalls „false“.True if this calendar is the user's default calendar, false otherwise.
namename ZeichenfolgeString Der Kalendername.The calendar name.

AntwortResponse

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und das aktualisierte calendar-Objekt im Antworttext zurückgegeben.If successful, this method returns a 200 OK response code and updated calendar object in the response body.

BeispielExample

AnforderungRequest

Im folgenden Beispiel wird der Name des Standardkalenders des angemeldeten Benutzers aktualisiert.The following example updates the name of the signed-in user's default calendar.

PATCH https://graph.microsoft.com/beta/me/calendar
Content-type: application/json

{
  "name": "Social events"
}
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
    "@odata.context":"https://graph.microsoft.com/beta/$metadata#me/calendars/$entity",
    "@odata.id":"https://graph.microsoft.com/beta/users('266efe5a-0fd7-4edd-877b-b2d1e561f193@ae01a323-3934-4475-a32d-af1274312bb0')/calendars('AAMkADJmMVAAA=')",
    "id":"AAMkADJmMVAAA=",
    "name":"Social events",
    "color":"auto",
    "hexColor": "",
    "isDefaultCalendar":false,
    "changeKey":"DxYSthXJXEWwAQSYQnXvIgAAIxGttg==",
    "canShare":true,
    "canViewPrivateItems":true,
    "isShared":false,
    "isSharedWithMe":false,
    "canEdit":true,
    "allowedOnlineMeetingProviders": [
                "teamsForBusiness"
            ],
    "defaultOnlineMeetingProvider": "teamsForBusiness",
    "isTallyingResponses": true,
    "isRemovable": false,
    "owner":{
        "name":"Samantha Booth",
        "address":"samanthab@adatum.onmicrosoft.com"
    }
}