Tipo de recurso mailSearchFolder

Espacio de nombres: microsoft.graph

MailSearchFolder es una carpeta virtual en el buzón del usuario que contiene todos los elementos de correo electrónico que coinciden con los criterios de búsqueda especificados. mailSearchFolder hereda de mailFolder. Las carpetas de búsqueda se pueden crear en cualquier carpeta del buzón de Exchange Online de un usuario. Sin embargo, para que una carpeta de búsqueda aparezca en Outlook, Outlook para la web o Outlook Live, la carpeta debe crearse en la carpeta WellKnownFolderName.SearchFolders .

Ciclo de vida de la carpeta de búsqueda

Exchange Online puede eliminar las carpetas de búsqueda creadas por la aplicación por una de las siguientes razones:

1. Las carpetas de búsqueda expiran después de 45 días sin uso.
2. Hay límites en el número de carpetas de búsqueda que se pueden crear por carpeta de origen. Cuando se infringe este límite, se eliminan las carpetas de búsqueda más antiguas para dar paso a las nuevas.

Cuando se elimina una carpeta de búsqueda, la aplicación debe crear un nuevo recurso de carpeta de búsqueda y usar el mismo.

Métodos

Método	Tipo de valor devuelto	Descripción
Crear carpeta de búsqueda de correo	mailSearchFolder	Cree una carpeta de búsqueda en el buzón de este usuario.
Enumerar carpetas secundarias	Colección mailFolder	Enumere todas las carpetas del buzón de este usuario, incluidas las carpetas de búsqueda.
Obtener carpeta de búsqueda de correo	mailSearchFolder	Obtenga la carpeta de búsqueda especificada.
Actualizar carpeta de búsqueda de correo	mailSearchFolder	Actualice la carpeta de búsqueda especificada.
Eliminar carpeta de búsqueda de correo	Ninguno	Elimine la carpeta de búsqueda especificada.
Enumerar mensajes en la carpeta	Colección message	Enumere todos los mensajes de la carpeta de búsqueda especificada.

Propiedades

Propiedad	Tipo	Descripción
filterQuery	Cadena	Consulta de OData para filtrar los mensajes.
includeNestedFolders	Booleano	Indica cómo se debe recorrer la jerarquía de carpetas del buzón en la búsqueda. true significa que se debe realizar una búsqueda profunda para incluir carpetas secundarias en la jerarquía de cada carpeta especificada explícitamente en sourceFolderIds. false significa una búsqueda superficial de solo cada una de las carpetas especificadas explícitamente en sourceFolderIds.
isSupported	Booleano	Indica si una carpeta de búsqueda es editable mediante las API REST.
sourceFolderIds	Colección de cadenas	Carpetas de buzón que se deben minado.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

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