type de ressource post
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Représente un élément de publication 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éer une extension d’ouverture et ajouter des propriétés personnalisées dans une ressource nouvelle ou existante. |
Obtenir une extension d’ouverture | collection openTypeExtension | Obtenir une extension d’ouverture identifiée par le nom de l’extension. |
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. Chaque catégorie correspond à la propriété displayName d’un outlookCategory qui a été défini pour un utilisateur. |
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. |
importance | importance | L’importance d’un billet de groupe : low , normal , high . |
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 | Collection de pièces jointes fileAttachment, itemAttachment et referenceAttachment pour le billet. 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 | Billet précédent auquel ce billet répond dans conversationThread. 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)",
"importance": "string",
"lastModifiedDateTime": "String (timestamp)",
"newParticipants": [{"@odata.type": "microsoft.graph.recipient"}],
"receivedDateTime": "String (timestamp)",
"sender": {"@odata.type": "microsoft.graph.recipient"}
}