Tipo de recurso specialFolder
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.
Grupos elementos de datos especiales relacionados con carpetas en una única estructura.
Si un driveItem tiene una faceta specialFolder que no es null, el elemento representa una carpeta especial (con nombre). Se puede obtener acceso a las carpetas especiales directamente a través de la colección de carpetas especiales.
Las carpetas especiales proporcionan alias simples para acceder a carpetas conocidas sin necesidad de buscar la carpeta por su ruta (que requeriría localización) o hacer referencia a la carpeta con un identificador. Si una carpeta especial cambia de nombre o se mueve a otra ubicación de la unidad, esta sintaxis seguirá devolviendo esa carpeta.
Las carpetas especiales se crean de forma automática la primera vez que una aplicación intenta escribir en una, si aún no existe. Si un usuario elimina una, se vuelve a crear al volver a escribir en ella.
Los siguientes nombres de carpeta especiales están disponibles en OneDrive y OneDrive para la Empresa.
| Nombre | Id. de carpeta | Descripción |
|---|---|---|
| Documentos | documents |
La carpeta Documentos. |
| Fotos | photos |
La carpeta Fotos. |
| Álbum de cámara | cameraroll |
La carpeta de copia de seguridad del álbum de cámara. |
| Raíz de la aplicación | approot |
La carpeta personal de la aplicación. Normalmente en /Apps/{Application Name}. |
| Música | music |
La carpeta Música. |
| Grabaciones | recordings |
La carpeta Grabaciones. Esta opción solo está disponible en OneDrive para la Empresa y SharePoint Online. |
Nota: Si la aplicación solo ha solicitado el ámbito Files.Read y solicita una carpeta especial que no existe, la respuesta será un error
403 Forbidden.
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| name | string | El identificador único de este elemento en la colección /drive/special |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"name": "string"
}
Contenido relacionado
Para obtener más información sobre las facetas de un driveItem, vea driveItem.