Tipo de recurso mailboxFolder
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.
Representa una carpeta en el buzón de un usuario, como bandeja de entrada, borradores u otras carpetas creadas por el usuario. Las carpetas pueden contener varios elementos de buzón de correo, como mensajes, eventos, contactos, otros elementos de Outlook y carpetas secundarias.
Este recurso admite consultas delta para realizar un seguimiento de las adiciones incrementales, eliminaciones y actualizaciones, proporcionando una función delta . También admite propiedades extendidas de valor único y de varios valores para almacenar y obtener acceso a datos personalizados que aún no están expuestos en los metadatos de Microsoft Graph API.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | colección mailboxFolder | Obtenga todos los objetos mailboxFolder del buzón especificado, incluidas las carpetas de búsqueda. |
| Crear | mailboxFolder | Cree un nuevo mailboxFolder o mailboxFolder secundario en el buzón de un usuario. |
| Get | mailboxFolder | Lea las propiedades y relaciones de un objeto mailboxFolder . |
| Actualizar | mailboxFolder | Actualice las propiedades mailboxFolder como displayName dentro de un buzón. |
| Delete | Ninguno | Elimine un mailboxFolder o un buzón secundarioFolder dentro de un buzón. |
| Obtener delta | colección mailboxFolder | Obtiene un conjunto de objetos mailboxFolder que se han agregado, eliminado o quitado del buzón del usuario. |
| Enumerar carpetas de buzones secundarios | colección mailboxFolder | Obtenga la colección mailboxFolder en el mailboxFolder especificado en un buzón. |
| Enumerar elementos en la carpeta | colección mailboxItem | Obtenga la colección mailboxItem dentro de un mailboxFolder especificado en un buzón. |
| Propiedades extendidas | ||
| Crear una propiedad de valor único | mailboxFolder | Cree una o varias propiedades extendidas de un solo valor en una carpeta de buzón nueva o existente. |
| Obtener una propiedad de valor único | mailboxFolder | Obtenga carpetas de buzón de correo que contengan una propiedad extendida de un solo valor mediante $expand o $filter. |
| Creación de una propiedad de varios valores | mailboxFolder | Cree una o varias propiedades extendidas de varios valores en una carpeta de buzón nueva o existente. |
| Obtención de la propiedad multivalor | mailboxFolder | Obtenga una carpeta de buzón de correo que contenga una propiedad extendida de varios valores mediante $expand. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| childFolderCount | Int32 | Número de carpetas secundarias inmediatas en la carpeta actual. |
| displayName | Cadena | Nombre para mostrar de la carpeta. |
| id | Cadena | Identificador único de la carpeta. |
| parentFolderId | Cadena | Identificador único de la carpeta primaria de esta carpeta. |
| parentMailboxUrl | Cadena | Vínculo de enrutamiento al buzón subyacente real donde reside físicamente la carpeta. Se puede acceder a la carpeta mediante GET {parentMailboxUrl}/folders/{id}, que trata toda la dirección URL como una cadena opaca. Este método es especialmente importante cuando el archivado de expansión automática está habilitado para el buzón de archivo local de un usuario. El contenido de archivo del usuario puede abarcar varios buzones en tales escenarios. |
| totalItemCount | Int32 | Número de elementos de la carpeta. |
| type | Cadena | Describe el tipo de clase de carpeta. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| childFolders | colección mailboxFolder | Colección de carpetas secundarias de esta carpeta. |
| items | colección mailboxItem | Colección de elementos de esta carpeta. |
| multiValueExtendedProperties | Colección multiValueLegacyExtendedProperty | Colección de propiedades extendidas de varios valores definidas para mailboxFolder. |
| singleValueExtendedProperties | Colección singleValueLegacyExtendedProperty | Colección de propiedades extendidas de valor único definidas para mailboxFolder. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.mailboxFolder",
"displayName": "String",
"childFolderCount": "Int32",
"id": "String (identifier)",
"parentFolderId": "String",
"parentMailboxUrl": "String",
"totalItemCount": "Int32",
"type": "String"
}