Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für: Entwickler
Verwenden Sie Metadaten, wenn Ihre App strukturierte Felder für Dateien in einem SharePoint Embedded-Container benötigt. Metadaten werden als Spalten auf einem fileStorageContainer und als Feldwerte auf den Elementen des Containerlaufwerks gespeichert. Ihre Anwendung ist für die Erstellung und Verwaltung des Spaltenschemas für jede Container-Instance verantwortlich. Eine vollständige Liste der Containerressourceneigenschaften finden Sie unter fileStorageContainer-Ressourcentyp.
Berechtigungen und unterstützte Aufrufer
Rufen Sie die Metadaten-APIs mit einem Nur-App- oder delegierten Bearertoken auf. Wird für Anwendungs- und delegierte Aufrufe verwendet FileStorageContainer.Selected .
Containerbesitzer und -manager können Spalten erstellen, aktualisieren und löschen. Containermitglieder können Spalten lesen und auflisten.
Spaltentypen auswählen
SharePoint Embedded-Metadaten unterstützen diese Spaltentypeigenschaften: boolean, choice, currency, dateTimehyperlinkOrPicture, numberpersonOrGroup, , und text. Es unterstützt auch Spalteneinstellungen wie indexed, isDeletable, isSealed, namereadOnly, und type.
Spaltennamen müssen SharePoint-Regeln entsprechen. Verwenden Sie keine Namen, die enthalten, mit einer Ziffer oder einem Satzzeichen beginnen !, Leerzeichen enthalten, wie Tabellenkalkulationszellverweise aussehen, lokalisierte wahre oder falsche Werte darstellen oder reservierte Namen wie Author, Created, oder Descriptionverwenden.
Erstellen einer Spalte
Erstellen Sie eine Spalte für den Container, bevor Sie Feldwerte in Dateien schreiben.
POST https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns
Content-Type: application/json
{
"description": "test",
"displayName": "Title",
"enforceUniqueValues": false,
"hidden": false,
"indexed": false,
"name": "Title",
"text": {
"allowMultipleLines": false,
"appendChangesToExistingText": false,
"linesForEditing": 0,
"maxLength": 255
}
}
Die Erstellungsanforderung unterstützt typenicht, und der Text maxLength muss kleiner oder gleich 255 sein.
Hinweis
Seit Januar 2026 sind die Containerspalten-APIs (auflisten, erstellen, aktualisieren, löschen von Spalten) auch allgemein auf dem Microsoft Graph-Endpunkt v1.0 verfügbar. Sie können in der Spalte unten "/v1.0/Anforderungen" ersetzen/beta/. Der Beta-Endpunkt bleibt verfügbar.
Spalten verwalten
Verwenden Sie die vom Erstellungs- oder Listenvorgang zurückgegebene Spalten-ID.
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns
GET https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
PATCH https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
DELETE https://graph.microsoft.com/beta/storage/fileStorage/containers/{container-id}/columns/{column-id}
Patchen Sie unterstützte Eigenschaften, wenn sich das Schema ändert. Sie können jede Eigenschaft einer Spalte aktualisieren, mit Ausnahme der id Eigenschaft.
{
"required": true,
"hidden": false,
"description": "This is my new column description"
}
Lesen und Schreiben von Dateimetadaten
Feldwerte werden in den Listenelementfeldern des Laufwerkelements gespeichert. Lesen Sie alle Felder oder wählen Sie diejenigen aus, die Ihre Benutzeroberfläche benötigt.
GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
GET https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields?$select=Name,Color
Patch-Feldwerte zum Aktualisieren von Metadaten. Wird verwendet null , um einen Feldwert zu löschen, wenn die Spalte leere Werte zulässt.
PATCH https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
Content-Type: application/json
{
"Color": "Fuchsia",
"Quantity": 934
}
{
"Color": null
}
Abfragen von Dateien nach Metadaten
Verwenden Sie OData-Abfrageoptionen für benutzerdefinierte Spalten, wenn Sie eine strukturierte Filterung oder Sortierung innerhalb eines Containerlaufwerks benötigen.
GET https://graph.microsoft.com/beta/drives/{drive-id}/items?$orderby=listitem/fields/TestField asc&$filter=startswith(listitem/fields/TestField, '3')&$expand=listitem($expand=fields)
Wird verwendet $expand=listitem($expand=fields) , wenn für das Ergebnis Feldwerte in der Antwort benötigt werden. Erstellen Sie indizierte Spalten für Filter mit hoher Kardinalität, die Ihre App häufig ausführt.
Informationen zur Volltextsuche über Container und benutzerdefinierte Metadaten hinweg finden Sie unter Suchen von Containern und Dateien. Informationen zum Filtern des semantischen Abrufs nach indizierten benutzerdefinierten Metadaten finden Sie unter Filterabruf nach benutzerdefinierten Metadaten. Beide Oberflächen verwenden von SharePoint verwaltete Eigenschaften, z. B. die OWSTEXT für eine Textspalte generierte Eigenschaft.
Verwenden Sie OData $filter für strukturierte Abfragen innerhalb eines Containerlaufwerks. Verwenden Sie die Suche nach Freitextabfragen in vielen Containern oder verwenden Sie die Retrieval-API, um Extrakte für die KI-Fundierung zurückzugeben.
Schema konsistent halten
Erstellen Sie die erforderlichen Spalten während der Containerbereitstellung. Speichern Sie die erwartete Schemaversion in Ihren App-Daten und führen Sie Migrationen aus, wenn neue Spalten eingeführt werden. Vermeiden Sie das Löschen von Spalten, bis Sie wissen, dass keine Workflows, Abfragen, Exporte oder Suchfunktionen von ihren Werten abhängen.