Beitragsressourcentyp
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta
Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt ein einzelnes Beitragselement innerhalb 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. |
Auf Beitrag antworten | Keine | Dient zum Antworten auf einen Beitrag und zum Hinzufügen eines neuen Beitrags zum angegebenen Thread in einer Gruppenunterhaltung. |
Beitrag weiterleiten | Keine | Dient zum Weiterleiten eines Beitrags an einen Empfänger. |
Anlagen | ||
List attachments | attachment collection | Ruft alle Anlagen für einen Beitrag ab. |
Hinzufügen von Anlagen | 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. |
Erweiterte Eigenschaften | ||
Einwertige Eigenschaft erstellen | post | Dient zum Erstellen einer oder mehrerer erweiterter einwertiger Eigenschaften in einem neuen oder vorhandenen Beitrag. |
Einwertige Eigenschaft abrufen | post | Dient zum Abrufen von Beiträgen mit einer erweiterten einwertigen Eigenschaft mithilfe von $expand oder $filter . |
Erstellen einer mehrwertigen Eigenschaft | post | Dient zum Erstellen einer oder mehrerer erweiterter mehrwertiger Eigenschaften in einem neuen oder vorhandenen Beitrag |
Abrufen einer mehrwertigen Eigenschaft | post | Dient zum Abrufen eines Beitrags mit einer erweiterten mehrwertigen Eigenschaft mithilfe von $expand . |
Eigenschaften
Eigenschaft | Typ | Beschreibung |
---|---|---|
Text | itemBody | Der Inhalt des Beitrags. Dies ist eine Standardeigenschaft. Für diese Eigenschaft sind Nullwerte zulässig. |
categories | String collection | Die Kategorien, die mit dem Beitrag verknüpft sind. Jede Kategorie entspricht der displayName-Eigenschaft eines outlookCategory-Objekts , das 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 | String | 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 | Boolean | Gibt an, ob der Beitrag mindestens eine Anlage enthält. Dies ist eine Standardeigenschaft. |
id | Zeichenfolge | 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 frühere Beitrag, auf den dieser Beitrag in conversationThread antwortet. Schreibgeschützt. Unterstützt $expand . |
multiValueExtendedProperties | multiValueLegacyExtendedProperty-Sammlung | Die Sammlung erweiterter mehrwertiger Eigenschaften, die für den Beitrag definiert sind. Schreibgeschützt. Nullwerte zulassend. |
singleValueExtendedProperties | singleValueLegacyExtendedProperty-Sammlung | Die Sammlung erweiterter einwertiger Eigenschaften, die für den Beitrag definiert sind. Schreibgeschützt. Nullwerte zulassend. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"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"}
}