Beitragsressourcentyp
Namespace: microsoft.graph
Wichtig
APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .
Stellt ein einzelnes Beitragselement in einer conversationThread-Entität dar.
Zwar können Sie Beiträge nicht explizit erstellen; es wird jedoch bei jedem der folgenden Vorgänge ein Beitrag erstellt:
- auf einen vorhandenen Beitrag antworten
- auf einen vorhandenen Thread antworten
- einen Thread in einer neuen Unterhaltung erstellen
- eine neue Unterhaltung erstellen
Diese Ressource ermöglicht es Ihnen, benutzerdefinierten Eigenschaften mithilfe von Erweiterungen eigene Daten hinzuzufügen.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List posts | post | Dient zum Abrufen der Beiträge des angegebenen Threads. |
| Get post | post | Dient zum Abrufen der Eigenschaften und der Beziehungen eines Beitrags in einem angegebenen Thread. |
| Reply | Keine | Dient zum Antworten auf einen Beitrag und zum Hinzufügen eines neuen Beitrags zum angegebenen Thread in einer Gruppenunterhaltung. |
| Forward | Keine | Dient zum Weiterleiten eines Beitrags an einen Empfänger. |
| Anlagen | ||
| List attachments | attachment-Sammlung | Ruft alle Anlagen für einen Beitrag ab. |
| Hinzufügen einer Anlage | attachment | Dient zum Hinzufügen einer Anlage zu einem Beitrag. |
| Offene Erweiterungen | ||
| Offene Erweiterung erstellen | openTypeExtension | Erstellt eine offene Erweiterung und fügt benutzerdefinierte Eigenschaften zu einer neuen oder vorhandenen Ressource hinzu. |
| Offene Erweiterung abrufen | openTypeExtension-Sammlung | Dient zum Abrufen einer offenen Erweiterung, die durch den Erweiterungsnamen identifiziert wird. |
| Schemaerweiterungen | ||
| Schemaerweiterungswerte hinzufügen | Dient zum Erstellen einer Schemaerweiterungsdefinition und anschließenden Verwenden der Definition zum Hinzufügen benutzerdefinierter typisierter Daten zu einer Ressource. | |
| Erweiterte Eigenschaften | ||
| Einwertige erweiterte Eigenschaft erstellen | post | Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen Beitrag. |
| Get post with single-value extended property | post | Dient zum Abrufen von Beiträgen mit einer erweiterten einwertigen Eigenschaft mithilfe von $expand oder $filter. |
| Create multi-value extended property | post | Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Beitrag |
| Get post with multi-value extended property | post | Dient zum Abrufen eines Beitrags mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| body | itemBody | Der Inhalt des Beitrags. Dies ist eine Standardeigenschaft. Für diese Eigenschaft sind Nullwerte zulässig. |
| categories | Zeichenfolgenauflistung | Die Kategorien, die mit dem Beitrag verknüpft sind. Jede Kategorie entspricht der displayName-Eigenschaft einer outlookCategory, die für einen Benutzer definiert wurde. |
| changeKey | String | Gibt die Version des Beitrags an. Jedes Mal, wenn der Beitrag geändert wird, wird auch ChangeKey geändert. Auf diese Weise kann Exchange Änderungen an der korrekten Version des Objekts vornehmen. |
| conversationId | String | Eindeutige ID der Unterhaltung. Schreibgeschützt. |
| conversationThreadId | Zeichenfolge | Eindeutige ID des Unterhaltungsthreads. Schreibgeschützt. |
| createdDateTime | DateTimeOffset | Gibt an, wann der Beitrag erstellt wurde. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| Von | Empfänger | Wird in Zugriffsszenarien mit Stellvertretungen verwendet. Gibt an, wer die Nachricht im Auftrag eines anderen Benutzers veröffentlicht hat. Dies ist eine Standardeigenschaft. |
| hasAttachments | Boolescher Wert | Gibt an, ob der Beitrag mindestens eine Anlage enthält. Dies ist eine Standardeigenschaft. |
| id | String | Schreibgeschützt. |
| Wichtigkeit | Wichtigkeit | Die Wichtigkeit eines Gruppenbeitrags: low , normal , high . |
| lastModifiedDateTime | DateTimeOffset | Gibt an, wann der Beitrag zuletzt geändert wurde. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| newParticipants | recipient collection | Teilnehmer einer Unterhaltung, die im Rahmen des Beitrags zu dem Thread hinzugefügt wurden. |
| receivedDateTime | DateTimeOffset | Gibt an, wann der Beitrag empfangen wurde. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Zum Beispiel, Mitternacht UTC am 1. Januar 2014 ist 2014-01-01T00:00:00Z |
| sender | Empfänger | Enthält die E-Mail-Adresse des Absenders. Bei dem Sender-Wert wird davon ausgegangen, dass dies die Adresse des authentifizierten Benutzers ist, wenn Absender nicht angegeben wurde. Dies ist eine Standardeigenschaft. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Anlagen | Anlagensammlung | Die Auflistung der FileAttachment-, itemAttachment-und referenceAttachment-Anlagen für den Beitrag. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand. |
| Erweiterungen | Erweiterungssammlung | Die Sammlung der für den Beitrag definierten offenen Erweiterungen. Schreibgeschützt. Nullwerte zulassend. Unterstützt $expand. |
| inReplyTo | Post | Der vorherige Beitrag, auf den dieser Beitrag im conversationThreadantworte. Schreibgeschützt. Unterstützt $expand. |
| multiValueExtendedProperties | multiValueLegacyExtendedProperty-Sammlung | Die Sammlung erweiterter mehrwertiger Eigenschaften, die für den Beitrag definiert sind. Schreibgeschützt. Lässt Nullwerte zu. |
| singleValueExtendedProperties | singleValueLegacyExtendedProperty-Sammlung | Die Sammlung erweiterter einwertiger Eigenschaften, die für den Beitrag definiert sind. Schreibgeschützt. Lässt Nullwerte zu. |
JSON-Darstellung
Es folgt eine JSON-Darstellung der Ressource.
{
"body": {"@odata.type": "microsoft.graph.itemBody"},
"categories": ["string"],
"changeKey": "string",
"conversationId": "string",
"conversationThreadId": "string",
"createdDateTime": "String (timestamp)",
"from": {"@odata.type": "microsoft.graph.recipient"},
"hasAttachments": true,
"id": "string (identifier)",
"importance": "string",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}
Siehe auch
Feedback
Feedback senden und anzeigen für