Type de ressource mailboxFolder
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 dossier dans la boîte aux lettres d’un utilisateur, tel que la boîte de réception, les brouillons ou d’autres dossiers créés par l’utilisateur. Les dossiers peuvent contenir différents éléments de boîte aux lettres tels que des messages, des événements, des contacts, d’autres éléments Outlook et des dossiers enfants.
Cette ressource prend en charge la requête delta pour suivre les ajouts incrémentiels, les suppressions et les mises à jour, en fournissant une fonction delta . Il prend également en charge les propriétés étendues à valeur unique et à valeurs multiples pour le stockage et l’accès aux données personnalisées qui ne sont pas déjà exposées dans les métadonnées microsoft API Graph.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| List | collection mailboxFolder | Obtenez tous les objets mailboxFolder dans la boîte aux lettres spécifiée, y compris les dossiers de recherche. |
| Create | mailboxFolder | Créez un mailboxFolder ou un boîte aux lettres enfant dans la boîte aux lettres d’un utilisateur. |
| Obtenir | mailboxFolder | Lit les propriétés et les relations d’un objet mailboxFolder . |
| Mettre à jour | mailboxFolder | Mettez à jour les propriétés mailboxFolder telles que displayName dans une boîte aux lettres. |
| Supprimer | Aucun | Supprimer un mailboxFolder ou un mailboxFolder enfant dans une boîte aux lettres. |
| Obtenir delta | collection mailboxFolder | Obtenez un ensemble d’objets mailboxFolder qui ont été ajoutés, supprimés ou supprimés de la boîte aux lettres de l’utilisateur. |
| Répertorier les dossiers de boîtes aux lettres enfants | collection mailboxFolder | Obtenez la collection mailboxFolder sous le mailboxFolder spécifié dans une boîte aux lettres. |
| Répertorier les éléments dans le dossier | collection mailboxItem | Obtient la collection mailboxItem dans un mailboxFolder spécifié dans une boîte aux lettres. |
| Propriétés étendues | ||
| Créer une propriété à valeur unique | mailboxFolder | Créez une ou plusieurs propriétés étendues à valeur unique dans un dossier de boîte aux lettres nouveau ou existant. |
| Obtenir une propriété à valeur unique | mailboxFolder | Obtenez des dossiers de boîte aux lettres qui contiennent une propriété étendue à valeur unique à l’aide de $expand ou $filter. |
| Créer une propriété à valeurs multiples | mailboxFolder | Créez une ou plusieurs propriétés étendues à valeurs multiples dans un dossier de boîte aux lettres nouveau ou existant. |
| Obtenir une propriété à valeurs multiples | mailboxFolder | Obtenez un dossier de boîte aux lettres qui contient une propriété étendue à valeurs multiples à l’aide de $expand. |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| childFolderCount | Int32 | Nombre de dossiers enfants immédiats dans le dossier actif. |
| displayName | String | Nom complet du dossier. |
| id | String | Identificateur unique du dossier. |
| parentFolderId | String | Identificateur unique du dossier parent de ce dossier. |
| parentMailboxUrl | String | Lien de routage vers la boîte aux lettres sous-jacente réelle où se trouve physiquement le dossier. Le dossier est accessible à l’aide GET {parentMailboxUrl}/folders/{id}de , qui traite l’URL entière comme une chaîne opaque. Cette méthode est particulièrement importante lorsque l’archivage à extension automatique est activé pour la boîte aux lettres d’archivage sur place d’un utilisateur. Le contenu d’archive de l’utilisateur peut s’étendre sur plusieurs boîtes aux lettres dans de tels scénarios. |
| totalItemCount | Int32 | Nombre d’éléments dans le dossier. |
| type | String | Décrit le type de classe de dossier. |
Relations
| Relation | Type | Description |
|---|---|---|
| childFolders | collection mailboxFolder | Collection de dossiers enfants dans ce dossier. |
| éléments | collection mailboxItem | Collection d’éléments de ce dossier. |
| multiValueExtendedProperties | collection multiValueLegacyExtendedProperty | Collection de propriétés étendues à valeurs multiples définies pour mailboxFolder. |
| singleValueExtendedProperties | collection singleValueLegacyExtendedProperty | Collection de propriétés étendues à valeur unique définies pour mailboxFolder. |
Représentation JSON
La représentation JSON suivante montre le type de ressource.
{
"@odata.type": "#microsoft.graph.mailboxFolder",
"displayName": "String",
"childFolderCount": "Int32",
"id": "String (identifier)",
"parentFolderId": "String",
"parentMailboxUrl": "String",
"totalItemCount": "Int32",
"type": "String"
}