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. Búsqueda carpetas se pueden crear en cualquier carpeta del buzón 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 Búsqueda carpeta
Búsqueda carpetas creadas por la aplicación se pueden eliminar mediante Exchange Online por uno de los siguientes motivos:
- Búsqueda carpetas expiran después de 45 días sin uso.
- 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 |
---|---|---|
Creación de una carpeta de búsqueda | mailSearchFolder | Cree una carpeta de búsqueda en el buzón de este usuario. |
Enumerar carpetas de búsqueda | Colección mailFolder | Enumere todas las carpetas del buzón de este usuario, incluidas las carpetas de búsqueda. |
Obtener una carpeta de búsqueda | mailSearchFolder | Obtenga la carpeta de búsqueda especificada. |
Actualización de una carpeta de búsqueda | mailSearchFolder | Actualice la carpeta de búsqueda especificada. |
Eliminación de una carpeta de búsqueda | Ninguno | Elimine la carpeta de búsqueda especificada. |
Enumerar todos los mensajes de una carpeta de búsqueda | 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 es una representación JSON del recurso
{
"isSupported": true,
"includeNestedFolders": true,
"sourceFolderIds": ["string"],
"filterQuery": "string"
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de