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.

Agrupa 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

Representación JSON

{
  "name": "string"
}

Contenido relacionado

Para obtener más información sobre las facetas de un driveItem, vea driveItem.