Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einer neuen oder vorhandenen Instanz einer Ressource.
Die folgenden Benutzerressourcen werden unterstützt:
- calendar
- contact
- contactFolder
- Ereignis
- mailboxFolder
- mailFolder
- message
- Hinweis
- todoTask
- todoTaskList
Die folgenden Gruppenressourcen:
Weitere Informationen dazu, wann Sie offene Erweiterungen oder erweiterte Eigenschaften verwenden und wie erweiterte Eigenschaften angegeben werden sollen, finden Sie unter Übersicht über erweiterte Eigenschaften.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
| Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Berechtigungen
Abhängig von der Ressource, für die Sie die erweiterte Eigenschaft erstellen, und dem Berechtigungstyp (delegiert oder Anwendung), den Sie anfordern, ist die in der folgenden Tabelle angegebene Berechtigung das Minimum, das zum Aufrufen dieser API erforderlich ist. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
| Unterstützte Ressource | Delegiert (Geschäfts-, Schul- oder Unikonto) | Delegiert (persönliches Microsoft-Konto) | Application |
|---|---|---|---|
| Kalender | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
| contact | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
| contactFolder | Contacts.ReadWrite | Contacts.ReadWrite | Contacts.ReadWrite |
| event | Calendars.ReadWrite | Calendars.ReadWrite | Calendars.ReadWrite |
| calendar-Ressourcen für Gruppen | Group.ReadWrite.All | Nicht unterstützt | Nicht unterstützt |
| event-Ressourcen für Gruppen | Group.ReadWrite.All | Nicht unterstützt | Nicht unterstützt |
| post-Ressourcen für Gruppen | Group.ReadWrite.All | Nicht unterstützt | Nicht unterstützt |
| mailboxFolder | MailboxFolder.Read | Nicht unterstützt | MailboxFolder.Read.All |
| mailFolder | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
| message | Mail.ReadWrite | Mail.ReadWrite | Mail.ReadWrite |
| Hinweis | ShortNotes.ReadWrite | ShortNotes.ReadWrite | ShortNotes.ReadWrite.All |
| todoTask | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
| todoTaskList | Tasks.ReadWrite | Tasks.ReadWrite | Tasks.ReadWrite.All |
HTTP-Anforderung
Sie können erweiterte Eigenschaften in einer neuen oder vorhandenen Ressourceninstanz erstellen.
Verwenden Sie zum Erstellen einer oder mehrerer erweiterter Eigenschaften in einer neuen Ressourceninstanz die gleiche REST-Anforderung wie zum Erstellen der Instanz, und fügen Sie die Eigenschaften der neuen Ressourceninstanz und die erweiterte Eigenschaft zum Anforderungstext hinzu. Einige Ressourcen unterstützen die Erstellung auf mehr als eine Weise. Weitere Informationen zum Erstellen dieser Ressourceninstanzen finden Sie in den entsprechenden Artikeln zum Erstellen einer Nachricht, eines MailOrdner, eines Ereignisses, eines Kalenders, eines Kontakts, eines contactFolder, eines Postfachordners, eines Gruppenereignisses, eines Gruppenbeitrags, einer todoTask und einer todoTaskList.
So sieht die Syntax der Anforderungen aus.
POST /me/messages
POST /users/{id|userPrincipalName}/messages
POST /me/mailFolders/{id}/messages
POST /me/mailFolders
POST /users/{id|userPrincipalName}/mailFolders
POST /me/events
POST /users/{id|userPrincipalName}/events
POST /me/calendars
POST /users/{id|userPrincipalName}/calendars
POST /me/contacts
POST /users/{id|userPrincipalName}/contacts
POST /me/contactFolders
POST /users/{id|userPrincipalName}/contactFolders
POST /admin/exchange/mailboxes/{mailboxId}/folders
POST /me/notes
POST /users/{id|userPrincipalName}/notes
POST /me/todo/lists/{todoTaskListId}/tasks
POST /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks
POST /me/todo/lists
POST /users/{id|userPrincipalName}/todo/lists
POST /groups/{id}/events
POST /groups/{id}/threads/{id}/posts/{id}/reply
POST /groups/{id}/conversations/{id}/threads/{id}/posts/{id}/reply
POST /groups/{id}/threads/{id}/reply
POST /groups/{id}/conversations/{id}/threads/{id}/reply
POST /groups/{id}/threads
POST /groups/{id}/conversations
Hinweis
Das Aufrufen des /me-Endpunkts erfordert einen angemeldeten Benutzer und daher eine delegierte Berechtigung. Anwendungsberechtigungen werden bei Verwendung des /me Endpunkts nicht unterstützt.
Um eine oder mehrere erweiterte Eigenschaften in einer vorhandenen Ressourceninstanz zu erstellen,müssen Sie die Instanz in der Anforderung angeben und die erweiterte-Eigenschaft zum Anforderungstext hinzufügen.
Hinweis Sie können keine erweiterte Eigenschaft in einem vorhandenen Gruppenbeitrag erstellen.
PATCH /me/messages/{id}
PATCH /users/{id|userPrincipalName}/messages/{id}
PATCH /me/mailFolders/{id}/messages/{id}
PATCH /me/mailFolders/{id}
PATCH /users/{id|userPrincipalName}/mailFolders/{id}
PATCH /me/events/{id}
PATCH /users/{id|userPrincipalName}/events/{id}
PATCH /me/calendars/{id}
PATCH /users/{id|userPrincipalName}/calendars/{id}
PATCH /me/contacts/{id}
PATCH /users/{id|userPrincipalName}/contacts/{id}
PATCH /me/contactFolders/{id}
PATCH /users/{id|userPrincipalName}/contactFolders/{id}
PATCH /admin/exchange/mailboxes/{mailboxId}/folders/{mailboxFolderId}
PATCH /me/notes/{id}
PATCH /users/{id|userPrincipalName}/notes/{id}
PATCH /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}/tasks/{todoTaskId}
PATCH /me/todo/lists/{todoTaskListId}
PATCH /users/{id|userPrincipalName}/todo/lists/{todoTaskListId}
PATCH /groups/{id}/events/{id}
Hinweis
Das Aufrufen des /me-Endpunkts erfordert einen angemeldeten Benutzer und daher eine delegierte Berechtigung. Anwendungsberechtigungen werden bei Verwendung des /me Endpunkts nicht unterstützt.
Anforderungsheader
| Name | Wert |
|---|---|
| Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
| Content-Type | application/json |
Anforderungstext
Stellen Sie einen JSON-Text für jedes singleValueLegacyExtendedProperty-Objekt in der singleValueExtendedProperties-Sammlungseigenschaft der Ressourceninstanz bereit.
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| singleValueExtendedProperties | singleValueLegacyExtendedProperty-Sammlung | Ein Array aus erweiterten mehrwertigen Eigenschaften. |
| id | Zeichenfolge | Geben Sie diese für jede Eigenschaft in der singleValueExtendedProperties-Sammlung an, um die Eigenschaft zu identifizieren. Sie muss eins der unterstützten Formate aufweisen. Weitere Informationen finden Sie unter Überblick über erweiterte Eigenschaften in Outlook. Erforderlich. |
| value | Zeichenfolge | Geben Sie für jede Eigenschaft in der singleValueExtendedProperties-Sammlung den Eigenschaftswert an. Erforderlich. |
Stellen Sie beim Erstellen einer erweiterten Eigenschaft in einer neuen Ressourcen-instance zusätzlich zur neuen singleValueExtendedProperties-Auflistung eine JSON-Darstellung dieser Ressourcen-Instance bereit (d. h. eine Nachricht, mailFolder, event, todoTask usw.).
Antwort
Antwortcode
Ist die Operation zur Erstellung einer erweiterten Eigenschaft in einer neuen Ressourceninstanz erfolgreich, wird 201 Created zurückgegeben. Ausnahme: In einem neuen Gruppenbeitrag kann die Operation je nach verwendeter Methode 200 OK oder 202 Accepted zurückgeben.
Eine erfolgreiche Erstellungsoperation in einer vorhandenen Ressourceninstanz gibt 200 OK zurück.
Antworttext
Wenn Sie eine erweiterte Eigenschaft erstellen, enthält die Antwort nur die neue oder bereits vorhandene Instanz, nicht jedoch die neue erweiterte Eigenschaft. Möchten Sie die neu erstellte erweiterte Eigenschaft sehen, müssen Sie die um die erweiterte Eigenschaft erweiterte Instanz abrufen.
Wenn Sie eine erweiterte Eigenschaft in einem neuenGruppenbeitrag erstellen, indem Sie auf einen Thread oder Beitrag antworten, enthält die Antwort nur einen Antwortcode, nicht jedoch den neuen Beitrag oder die erweiterte Eigenschaft.
Beispiele
Beispiel 1: Erstellen eines neuen Ereignisses und einer einwertigen erweiterten Eigenschaft
Anforderung
Im ersten Beispiel werden ein neues Ereignis und eine einwertige erweiterte Eigenschaft im selben POST-Vorgang erstellt. Neben den Eigenschaften, die Sie normalerweise für ein neues Ereignis einschließen würden, enthält der Anforderungstext die SingleValueExtendedProperties-Auflistung , die eine einwertige erweiterte Eigenschaft enthält, und Folgendes für die Eigenschaft:
-
ID Gibt den Eigenschaftstyp als
String, die GUID und die Eigenschaft mit dem NamenFunan. -
Wert Gibt
Foodals den Wert derFun-Eigenschaft an.
POST https://graph.microsoft.com/v1.0/me/events
Content-Type: application/json
{
"subject": "Celebrate Thanksgiving",
"body": {
"contentType": "HTML",
"content": "Let's get together!"
},
"start": {
"dateTime": "2015-11-26T18:00:00",
"timeZone": "Pacific Standard Time"
},
"end": {
"dateTime": "2015-11-26T23:00:00",
"timeZone": "Pacific Standard Time"
},
"attendees": [
{
"emailAddress": {
"address": "Terrie@contoso.com",
"name": "Terrie Barrera"
},
"type": "Required"
}
],
"singleValueExtendedProperties": [
{
"id":"String {66f5a359-4659-4830-9070-00040ec6ac6e} Name Fun",
"value":"Food"
}
]
}
Antwort
Eine erfolgreiche Antwort wird mit dem Antwortcode HTTP 201 Created gekennzeichnet und enthält das neue Ereignis im Antworttext, ähnlich wie die Antwort, die zurückgegeben wird, wenn Sie nur ein Ereignis erstellen. Die Antwort enthält keine neu erstellten erweiterten Eigenschaften.
Möchten Sie die neu erstellte erweiterte Eigenschaft sehen, müssen Sie das um die erweiterte Eigenschaft erweiterte Ereignis abrufen.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('c71-86a-a0-92-906ba')/events/$entity",
"@odata.etag": "W/\"oBeN/g==\"",
"id": "AAMkADI4Yzc5AABVNeEhAAA=",
"createdDateTime": "2023-06-26T15:46:00.9307807Z",
"lastModifiedDateTime": "2023-06-26T15:46:02.0775731Z",
"changeKey": "oBEEg==",
"categories": [],
"transactionId": null,
"originalStartTimeZone": "Pacific Standard Time",
"originalEndTimeZone": "Pacific Standard Time",
"iCalUId": "04049ACBF84A7AC7CB34D",
"reminderMinutesBeforeStart": 15,
"isReminderOn": true,
"hasAttachments": false,
"subject": "Celebrate Thanksgiving",
"bodyPreview": "Let's get together!",
"importance": "normal",
"sensitivity": "normal",
"isAllDay": false,
"isCancelled": false,
"isOrganizer": true,
"responseRequested": true,
"seriesMasterId": null,
"showAs": "busy",
"type": "singleInstance",
"webLink": "https://outlook.office365.com/owa/?itemid=AAMkAA%3D&exvsurl=1&path=/calendar/item",
"onlineMeetingUrl": null,
"isOnlineMeeting": false,
"onlineMeetingProvider": "unknown",
"allowNewTimeProposals": true,
"occurrenceId": null,
"isDraft": false,
"hideAttendees": false,
"responseStatus": {
"response": "organizer",
"time": "0001-01-01T00:00:00Z"
},
"body": {
"contentType": "html",
"content": "<html><head><meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\"></head><body>Let's get together!</body></html>"
},
"start": {
"dateTime": "2015-11-26T18:00:00.0000000",
"timeZone": "Pacific Standard Time"
},
"end": {
"dateTime": "2015-11-26T23:00:00.0000000",
"timeZone": "Pacific Standard Time"
},
"location": {
"displayName": "",
"locationType": "default",
"uniqueIdType": "unknown",
"address": {},
"coordinates": {}
},
"locations": [],
"recurrence": null,
"attendees": [
{
"type": "required",
"status": {
"response": "none",
"time": "0001-01-01T00:00:00Z"
},
"emailAddress": {
"name": "Terrie Barrera",
"address": "Terrie@contoso.com"
}
}
],
"organizer": {
"emailAddress": {
"name": "MOD Administrator",
"address": "admin@contoso.com"
}
},
"onlineMeeting": null
}
Beispiel 2: Erstellen einer einwertigen erweiterten Eigenschaft für eine Nachricht
Anforderung
Das zweite Beispiel erstellt eine einwertige erweiterte Eigenschaft für die angegebene vorhandene Nachricht. Diese erweiterte Eigenschaft ist das einzige Element in dem singleValueExtendedProperties-Array. Der Anforderungstext enthält die folgenden Parameter für diese erweiterte Eigenschaft:
-
ID Gibt den Eigenschaftstyp als
String, die GUID und dieColor-Eigenschaft an. -
Wert Gibt
Greenals den Wert derColor-Eigenschaft an.
PATCH https://graph.microsoft.com/v1.0/me/messages/AAMkAGE1M2_bs88AACHsLqWAAA=
Content-Type: application/json
{
"singleValueExtendedProperties": [
{
"id":"String {66f5a359-4659-4830-9070-00047ec6ac6e} Name Color",
"value":"Green"
}
]
}
Antwort
Eine erfolgreiche Antwort wird mit dem Antwortcode HTTP 200 OK gekennzeichnet und enthält die angegebene Nachricht im Antworttext, ähnlich wie die Antwort, die zurückgegeben wird, wenn Sie eine Nachricht aktualisieren. Die Antwort enthält nicht die neu erstellte erweiterte Eigenschaft.
Möchten Sie die neu erstellte erweiterte Eigenschaft sehen, müssen Sie die um die erweiterte Eigenschaft erweiterte Nachricht abrufen.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('3cc-ad3-4b9-9a-54')/messages/$entity",
"@odata.etag": "W/\"CQAAABTiMty\"",
"id": "AAMkADQzZ1NzItKbS4P8E6VEAAA3LwToAAA=",
"createdDateTime": "2023-05-12T15:55:56Z",
"lastModifiedDateTime": "2023-06-23T17:45:43Z",
"changeKey": "CQAAAAABTiMty",
"categories": [],
"receivedDateTime": "2023-05-12T15:55:57Z",
"sentDateTime": "2023-05-12T15:55:48Z",
"hasAttachments": false,
"internetMessageId": "<odspmicro-PlannerDueDate-06c7f00e-6b5f793846-DispatchToRecipients-PreprocessPayload-r0-SendEmail@59C185B>",
"subject": "You have upcoming tasks due",
"bodyPreview": "Hi Alex. You have 2 tasks due. You have upcoming tasksSubmit your expensesIn the plan Event Plan 5/19/2023Due in 7 daysSubmit your expensesIn the plan Event Plan 5/19/2023Due in 7 daysView tasks in Microsoft To ",
"importance": "normal",
"parentFolderId": "AQMkc0BAIptLg-wTpUQAAAIBDAAAAA==",
"conversationId": "AAQkADQzZmJLgzlRSFD0=",
"conversationIndex": "AQHIUPQ==",
"isDeliveryReceiptRequested": null,
"isReadReceiptRequested": false,
"isRead": false,
"isDraft": false,
"webLink": "https://outlook.office365.com/owa/?ItemID=AAP8E6vsurl=1&viewmodel=ReadMessageItem",
"inferenceClassification": "focused",
"body": {
"contentType": "html",
"content": "<html aria-hidden=\"true\" role=\"presentation\" height=\"1\" width=\"1\"></html>"
},
"sender": {
"emailAddress": {
"name": "Microsoft on behalf of your organization",
"address": "noreply@planner.office365.com"
}
},
"from": {
"emailAddress": {
"name": "Microsoft on behalf of your organization",
"address": "noreply@planner.office365.com"
}
},
"toRecipients": [
{
"emailAddress": {
"name": "Alex Wilber",
"address": "AlexW@contoso.com"
}
}
],
"ccRecipients": [],
"bccRecipients": [],
"replyTo": [],
"flag": {
"flagStatus": "notFlagged"
}
}