Usar una carpeta de aplicación para almacenar contenido de usuarios sin acceso a todos los archivos
La carpeta de aplicaciones es una carpeta especial y dedicada para su aplicación.
La carpeta de aplicaciones aparece normalmente después de su aplicación y se puede encontrar en la carpeta Aplicaciones en el OneDrive del usuario.
Si solicita el ámbito de permiso Files.ReadWrite.AppFolder
y el usuario lo autoriza, la aplicación obtiene acceso de lectura y escritura a esta carpeta.
Como se comporta como cualquier otra carpeta del OneDrive del usuario, los usuarios pueden agregar, modificar o quitar contenido de ella. La aplicación no necesita mantener una lógica exclusiva para el usuario, lo que le permite cambiarle el nombre o moverla.
Obtener autorización del usuario
Para tener su propia carpeta de la aplicación, debe solicitar el ámbito de permiso Files.ReadWrite.AppFolder
o Files.ReadWrite
al obtener un token de acceso.
Para obtener más información, consulte la autenticación.
Crear la carpeta de la aplicación
OneDrive crea la carpeta de la aplicación en la carpeta Apps
del usuario, situada en la raíz del OneDrive del usuario, cuando la aplicación realiza la primera llamada a la carpeta con el espacio de nombres carpeta especial.
A continuación se muestran las llamadas más comunes que la aplicación puede realizar para crear la carpeta la primera vez.
- Obtener los metadatos de la carpeta de la aplicación:
GET /drive/special/approot
- Mostrar los elementos secundarios de la carpeta de la aplicación:
GET /drive/special/approot/children
- Crear una carpeta en el AppRoot:
POST /drive/special/approot/children
- Crear una sesión de carga:
POST /drive/special/approot:/{filename}:/createUploadSession
- Cargar el contenido de un elemento:
PUT /drive/special/approot:/{fileName}:/content
- Cargar el contenido de un elemento con metadatos:
POST /drive/special/approot/children
- Cargar el contenido de un elemento desde una dirección URL:
POST /drive/special/approot/children
Asignar un nombre a la carpeta de la aplicación
Cuando OneDrive crea la carpeta de la aplicación, usa el nombre de aplicación establecido en ese momento para el id. de la aplicación de llamada. Puede cambiar el nombre de la carpeta de la aplicación en la página de registros de Azure App. Si decide realizar esta acción, puede localizar el nombre de la carpeta de la aplicación si va a la página de registros de Azure App y edita la configuración de localización de la aplicación. Al cambiar el nombre de carpeta de la aplicación en la página de registros de App de Azure no se cambiará el nombre de las carpetas especiales existentes asociadas a la aplicación.
Trabajar con la carpeta de la aplicación
La carpeta de la aplicación admite todas las operaciones item
estándar.
Tarea común | Método HTTP (por ruta de acceso) |
---|---|
Obtener los metadatos de un elemento | GET /drive/special/approot:/{path} |
Mostrar los elementos secundarios de un elemento | GET /drive/special/approot:/{path}:/children |
Crear un elemento | PUT /drive/special/approot:/{parent-path}/{name} |
Cargar el contenido de un elemento | PUT /drive/special/approot:/{parent-path}/{name}:/content |
Actualizar el contenido de un elemento | PATCH /drive/special/approot:/{path} |
Eliminar un elemento | DELETE /drive/special/approot:/{path} |
Mover un elemento | PATCH /drive/special/approot:/{path} |
Copiar un elemento | POST /drive/special/approot:/{path}:/action.copy |
Descargar el contenido de un elemento | GET /drive/special/approot:/{path}:/content |
Descargar el formato de archivo específico | GET /drive/special/approot:/{path}:/content?format={format} |
Búsqueda de un elemento | GET /drive/special/approot:/{path}:/search |
Ver los cambios en un elemento | GET /drive/special/approot:/{path}:/delta |
Obtener las miniaturas de un elemento | GET /drive/special/approot:/{path}:/thumbnails |