tipo de recurso mailSearchFolder

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Un 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. Pero para que una carpeta de búsqueda aparezca en Outlook, Outlook para la Web o Outlook Live, debe crearse en la carpeta WellKnownFolderName.SearchFolders.

Ciclo de vida de la carpeta de búsqueda

Exchange Online puede eliminar carpetas de búsqueda creadas por su 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 supera este límite, las carpetas de búsqueda más antiguas se eliminan para dar paso a otras nuevas.

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

Métodos

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

Propiedades

Propiedad Tipo Descripción
isSupported Booleano Indica si una carpeta de búsqueda se puede editar mediante API REST.
includeNestedFolders Booleano Indica cómo se debe recorrer la jerarquía de carpetas de buzones 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.
sourceFolderIds Colección string Carpetas de buzones que se deben minar.
filterQuery Cadena Consulta OData para filtrar los mensajes.

Relaciones

Ninguna.

Representación JSON

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

{
  "isSupported": true,
  "includeNestedFolders": true,
  "sourceFolderIds": ["string"],
  "filterQuery": "string"
}
  • Last updated on