type de ressource post
Espace de noms : microsoft.graph Représente un élément Post individuel au sein d’une entité conversationThread .
Même si vous ne pouvez pas créer un billet explicitement, vous en créez lorsque vous effectuez l’une des opérations suivantes :
- Répondre à un billet existant
- Répondre à un thread existant
- Créer un thread dans une nouvelle conversation
- créez une conversation.
Cette ressource vous permet d’ajouter vos propres données à des propriétés personnalisées à l’aide des extensions.
Méthodes
| Méthode | Type renvoyé | Description |
|---|---|---|
| Répertorier les billets | post | Obtenez les billets du thread spécifié. |
| Obtenir un billet | post | Obtenez les propriétés et les relations d’un billet dans un thread spécifié. |
| Répondre à une publication | Aucun | Répondez à un billet et ajoutez un nouveau billet au thread spécifié dans une conversation de groupe. |
| Transférer une publication | Aucun | Transférez un billet à un destinataire. |
| Attachments | ||
| Répertorier les pièces jointes | Collection attachment | Obtient toutes les pièces jointes d’un billet. |
| Add attachment | attachment | Ajoute une pièce jointe à un billet. |
| Extensions d’ouverture | ||
| Créer une extension d’ouverture | openTypeExtension | Crée une extension d’ouverture et ajoute des propriétés personnalisées dans une instance nouvelle ou existante d’une ressource. |
| Obtenir une extension d’ouverture | collection openTypeExtension | Obtient un objet d’extension d’ouverture ou des objets identifiés par leur nom ou leur nom complet. |
| Propriétés étendues | ||
| Créer une propriété à valeur unique | post | Créez une ou plusieurs propriétés étendues à valeur unique dans un billet nouveau ou existant. |
| Obtenir une propriété à valeur unique | post | Obtenez les billets contenant une propriété étendue à valeur unique à l’aide de $expand ou $filter. |
| Créer une propriété à valeurs multiples | post | Créez une ou plusieurs propriétés étendues à valeurs multiples dans un billet nouveau ou existant. |
| Obtenir une propriété à valeurs multiples | post | Obtenez un billet qui contient une propriété étendue à valeurs multiples à l’aide de $expand. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| corps | itemBody | Contenu du billet. Il s’agit d’une propriété par défaut. Cette propriété peut avoir la valeur Null. |
| categories | Collection de chaînes | Les catégories associées au billet. |
| changeKey | String | Identifie la version du billet. Chaque fois que le billet est modifié, ChangeKey change également. Cela permet à Exchange d’appliquer les modifications à la version correcte de l’objet. |
| conversationId | Chaîne | ID unique de la conversation. En lecture seule. |
| conversationThreadId | Chaîne | ID unique du thread de conversation. En lecture seule. |
| createdDateTime | DateTimeOffset | Spécifie quand le billet a été créé. Le type DateTimeOffset représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| from | recipient | Utilisé dans les scénarios d’accès délégué. Indique qui a publié le message pour le compte d’un autre utilisateur. Il s’agit d’une propriété par défaut. |
| hasAttachments | Booléen | Indique si le billet comporte au moins une pièce jointe. Il s’agit d’une propriété par défaut. |
| id | Chaîne | En lecture seule. |
| lastModifiedDateTime | DateTimeOffset | Spécifie quand le billet a été modifié pour la dernière fois. Le type DateTimeOffset représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| newParticipants | collection recipient | Participants à la conversation qui ont été ajoutés au thread dans le cadre de ce billet. |
| receivedDateTime | DateTimeOffset | Spécifie quand la publication a été reçue. Le type DateTimeOffset représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. |
| sender | recipient | Contient l’adresse de l’expéditeur. La valeur de Sender est supposée être l’adresse de l’utilisateur authentifié au cas où l’expéditeur n’est pas spécifié. Il s’agit d’une propriété par défaut. |
Relations
| Relation | Type | Description |
|---|---|---|
| pièces jointes | collection attachment | En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand. |
| extensions | collection Extension | Collection d’extensions ouvertes définies pour le billet. En lecture seule. Pouvant accepter la valeur Null. Prend en charge $expand. |
| inReplyTo | post | En lecture seule. Prend en charge $expand. |
| multiValueExtendedProperties | collection multiValueLegacyExtendedProperty | Collection des propriétés étendues à valeurs multiples définies pour le billet. En lecture seule. Pouvant accepter la valeur Null. |
| singleValueExtendedProperties | collection singleValueLegacyExtendedProperty | Collection des propriétés étendues à valeur unique définies pour le billet. En lecture seule. Pouvant accepter la valeur Null. |
Représentation JSON
La représentation JSON suivante montre le type de 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)",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}