Type de ressource mailSearchFolder

  • Article

Espace de noms: microsoft.graph

Un mailSearchFolder est un dossier virtuel dans la boîte aux lettres de l’utilisateur qui contient tous les éléments d’e-mail correspondant aux critères de recherche spécifiés. mailSearchFolder hérite de mailFolder. Recherche dossiers peuvent être créés dans n’importe quel dossier de la boîte aux lettres Exchange Online d’un utilisateur. Toutefois, pour qu’un dossier de recherche apparaisse dans Outlook, Outlook pour le Web ou Outlook Live, le dossier doit être créé dans le dossier WellKnownFolderName.SearchFolders.

Recherche cycle de vie des dossiers

Recherche dossiers créés par votre application peuvent être supprimés par Exchange Online pour l’une des raisons suivantes :

  1. Recherche dossiers expirent après 45 jours sans aucune utilisation.
  2. Le nombre de dossiers de recherche pouvant être créés par dossier source est limité. En cas de dépassement de cette limite, les dossiers de recherche plus anciens sont supprimés pour faire place à de nouveaux dossiers.

Lorsqu’un dossier de recherche est supprimé, votre application doit créer une ressource de dossier de recherche et l’utiliser.

Méthodes

Méthode Type renvoyé Description
Créer un dossier de recherche mailSearchFolder Créez un dossier de recherche dans la boîte aux lettres de cet utilisateur.
Répertorier les dossiers de recherche collection mailFolder Répertoriez tous les dossiers de la boîte aux lettres de cet utilisateur, y compris les dossiers de recherche.
Obtenir un dossier de recherche mailSearchFolder Obtient le dossier de recherche spécifié.
Mettre à jour un dossier de recherche mailSearchFolder Mettez à jour le dossier de recherche spécifié.
Supprimer un dossier de recherche Aucune Supprimez le dossier de recherche spécifié.
Répertorier tous les messages d’un dossier de recherche collection message Répertoriez tous les messages dans le dossier de recherche spécifié.

Propriétés

Propriété Type Description
filterQuery Chaîne Requête OData pour filtrer les messages.
includeNestedFolders Valeur booléenne Indique comment la hiérarchie des dossiers de boîtes aux lettres doit être parcourue dans la recherche. true signifie qu’une recherche approfondie doit être effectuée pour inclure les dossiers enfants dans la hiérarchie de chaque dossier explicitement spécifié dans sourceFolderIds. false signifie une recherche superficielle de chacun des dossiers explicitement spécifiés dans sourceFolderIds.
isSupported Valeur booléenne Indique si un dossier de recherche peut être modifié à l’aide d’API REST.
sourceFolderIds String collection Dossiers de boîte aux lettres qui doivent être extraits.

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "isSupported": true,
  "includeNestedFolders": true,
  "sourceFolderIds": ["string"],
  "filterQuery": "string"
}