Verwenden eines App-Ordners zum Speichern von Benutzerinhalten ohne Zugriff auf alle Dateien
Der App-Ordner ist ein dedizierter, spezieller Ordner für Ihre App.
Der App-Ordner wird üblicherweise nach Ihrer App benannt und befindet sich im Ordner Apps im OneDrive des Benutzers.
Wenn Sie den Files.ReadWrite.AppFolder-Berechtigungsumfang anfordern und der Benutzer diesen autorisiert, erhält Ihre App Lese- und Schreibzugriff auf diesen Ordner.
Da er sich wie jeder andere Ordner im OneDrive des Benutzers verhält, können Benutzer Inhalte hinzufügen, ändern und entfernen. Ihre App muss nicht logisch eindeutig für den Benutzer bleiben, sodass der Benutzer sie umbenennen oder verschieben kann.
Erhalt der Autorisierung durch den Benutzer
Wenn Sie über einen eigenen Ordner für Ihre App verfügen, müssen Sie beim Abrufen eines Access-Token entweder den Files.ReadWrite.AppFolder- oder Files.ReadWrite-Berechtigungsumfang anfordern.
Weitere Informationen finden Sie unter Authentifizierung.
Erstellen des Ordners für Ihre App
OneDrive erstellt den Ordner für Ihre App im Apps-Ordner des Benutzers im Stammverzeichnis des OneDrive des Benutzers, wenn Ihre App zum ersten Mal den Namespace spezieller Ordner aufruft.
Im Folgenden finden Sie die am häufigsten verwendeten Aufrufe, die Ihre App machen kann, um den Ordner anfangs zu erstellen.
- Abrufen der Metadaten Ihres App-Ordners:
GET /drive/special/approot - Auflisten der untergeordneten Elemente Ihres App-Ordners:
GET /drive/special/approot/children - Erstellen eines Ordners unter dem App-Stammverzeichnis:
POST /drive/special/approot/children - Erstellen einer Uploadsitzung:
POST /drive/special/approot:/{filename}:/createUploadSession - Hochladen der Inhalte eines Elements:
PUT /drive/special/approot:/{fileName}:/content - Hochladen der Inhalte eines Elements mit Metadaten:
POST /drive/special/approot/children - Hochladen der Inhalte eines Elements von der URL:
POST /drive/special/approot/children
Benennen des Ordners für Ihre App
Wenn OneDrive den Ordner für Ihre App erstellt, verwendet den Anwendungsnamen, der zu diesem Zeitpunkt festgelegt wird, als ID der aufrufenden App. Sie können den Namen des Ordners für Ihre App inn der Registrierungsseite der Azure-App ändern. Wenn Sie möchten, können Sie den Namen des Ordners für Ihre App lokalisieren, indem Sie zur Registrierungsseite der Azure-App gehen und die Lokalisierungseinstellungen für Ihre App bearbeiten. Wenn Sie den Ordnernamen Ihrer App auf der Seite Azure-App Registrierungen ändern, werden vorhandene spezielle Ordner, die Ihrer App zugeordnet sind, nicht umbenannt.
Arbeiten mit dem Ordner für Ihre App
Der Ordner für Ihre App unterstützt alle item-Standardvorgänge.
| Häufige Aufgaben | HTTP-Methode (nach Pfad) |
|---|---|
| Abrufen von Metadaten für ein Element | GET /drive/special/approot:/{path} |
| Auflisten der untergeordneten Elemente eines Elements | GET /drive/special/approot:/{path}:/children |
| Erstellen eines Elements | PUT /drive/special/approot:/{parent-path}/{name} |
| Hochladen der Inhalte eines Elements | PUT /drive/special/approot:/{parent-path}/{name}:/content |
| Aktualisieren der Inhalte eines Elements | PATCH /drive/special/approot:/{path} |
| Löschen eines Elements | DELETE /drive/special/approot:/{path} |
| Verschieben eines Elements | PATCH /drive/special/approot:/{path} |
| Kopieren eines Elements | POST /drive/special/approot:/{path}:/action.copy |
| Herunterladen der Inhalte eines Elements | GET /drive/special/approot:/{path}:/content |
| Herunterladen eines bestimmten Dateiformats | GET /drive/special/approot:/{path}:/content?format={format} |
| Suchen nach einem Element | GET /drive/special/approot:/{path}:/search |
| Anzeigen von Änderungen für ein Element | GET /drive/special/approot:/{path}:/delta |
| Abrufen von Miniaturansichten für ein Element | GET /drive/special/approot:/{path}:/thumbnails |