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 del buzón de un usuario, como la bandeja de entrada, borradores u otras carpetas creadas por el usuario. Las carpetas pueden contener varios elementos del buzón como mensajes, eventos, contactos, otros elementos de Outlook y carpetas secundarias.

Este recurso admite la consulta delta para realizar un seguimiento de las adiciones, eliminaciones y actualizaciones incrementales, mediante la provisión de una función delta . También admite propiedades extendidas de valor único y de varios valores para almacenar y acceder a datos personalizados que aún no están expuestos en los metadatos de la Microsoft Graph API.

Métodos

Método Tipo devuelto Descripción
List mailboxColección de carpetas Obtener todos los objetos mailboxFolder del buzón especificado, incluidas las carpetas de búsqueda.
Crear carpeta de buzón Crear un nuevo buzónCarpeta o buzón secundarioCarpeta en el buzón de un usuario.
Get carpeta de buzón Lea las propiedades y relaciones de un objeto mailboxFolder .
Actualizar carpeta de buzón Actualice las propiedades mailboxFolder , como displayName dentro de un buzón.
Delete Ninguno Eliminar un buzónCarpeta o un buzón secundarioCarpeta dentro de un buzón.
Obtener delta mailboxColección de carpetas Obtenga un conjunto de objetos mailboxFolder que se agregaron, eliminaron o quitaron del buzón del usuario.
Enumerar carpetas de buzones secundarios mailboxColección de carpetas Obtenga la colección mailboxFolder en el mailboxFolder especificado en un buzón.
Enumerar elementos de la carpeta mailboxItem collection Obtener la colección mailboxItem dentro de una carpeta mailboxFolder especificada en un buzón.
Eliminar elemento de la carpeta Ninguno Eliminar un elemento de buzón de un buzónCarpeta en un buzón.
Propiedades extendidas
Crear una propiedad de valor único carpeta de buzón Cree una o varias propiedades extendidas de valor único en una carpeta de buzón nueva o existente.
Obtener una propiedad de valor único carpeta de buzón Obtenga las carpetas de buzones de correo que contienen una propiedad extendida de un solo valor mediante $expand o $filter.
Crear propiedad de varios valores carpeta de buzón Cree una o varias propiedades extendidas de varios valores en una carpeta de buzón nueva o existente.
Obtener propiedad de varios valores carpeta de buzón Obtenga una carpeta de buzón que contenga una propiedad extendida de varios valores mediante $expand.

Propiedades

Propiedad Tipo Descripción
childFolderCount Int32 El número de carpetas secundarias inmediatas en la carpeta actual.
displayName Cadena El nombre para mostrar de la carpeta.
id Cadena El identificador único de la carpeta.
parentFolderId Cadena El identificador único de la carpeta primaria de esta carpeta.
parentMailboxUrl Cadena El 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 la expansión automática del archivado está habilitada para el buzón de archivo local de un usuario. En estos casos, el contenido del archivo del usuario puede abarcar varios buzones.
totalItemCount Int32 El número de elementos de la carpeta.
type Cadena Describe el tipo de clase de carpeta.
wellKnownName Cadena El nombre conocido independiente de la configuración regional de la carpeta para carpetas creadas por Outlook, como inbox, , sentitems, draftsdeleteditems, o archive. Para las carpetas creadas por el usuario, el valor es null. Solo lectura.

Relaciones

Relación Tipo Descripción
childFolders mailboxColección de carpetas La colección de carpetas secundarias de esta carpeta.
items mailboxItem collection La 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 un solo valor 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",
  "wellKnownName": "String",
  "type": "String"
}
  • Last updated on