Beitragsressourcentyp
Namespace: microsoft.graph Stellt ein einzelnes Post-Element 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 in einer neuen oder vorhandenen Instanz einer Ressource hinzu. |
| Offene Erweiterung abrufen | openTypeExtension-Sammlung | Ruft ein offenes Erweiterungsobjekt oder Objekte basierend auf ihrem Namen oder vollqualifizierten Namen ab. |
| 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. |
| 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. |
| 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 | 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 | 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)",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}