Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
S’applique à : Développeur
Utilisez des métadonnées lorsque votre application a besoin de champs structurés sur des fichiers dans un conteneur SharePoint Embedded. Les métadonnées sont stockées sous forme de colonnes sur un fileStorageContainer et en tant que valeurs de champ sur les éléments du lecteur de conteneur. Votre application est chargée de créer et de gérer le schéma de colonne pour chaque conteneur instance. Pour obtenir la liste complète des propriétés de ressource de conteneur, consultez Type de ressource fileStorageContainer.
Autorisations et appelants pris en charge
Appelez les API de métadonnées avec un jeton de porteur délégué ou d’application uniquement. Utilisez pour les FileStorageContainer.Selected appels d’application et délégués.
Les propriétaires de conteneurs peuvent créer, mettre à jour et supprimer des colonnes. Les membres du conteneur peuvent lire et répertorier des colonnes.
Choisir des types de colonnes
Les métadonnées SharePoint Embedded prennent en charge ces propriétés de type de colonne : boolean, choicecurrency, dateTime, hyperlinkOrPicture, number, personOrGroup, et text. Il prend également en charge les paramètres de colonne tels que indexed, isSealedisDeletable, name, readOnly, et type.
Les noms de colonnes doivent respecter les règles SharePoint. N’utilisez pas de noms qui contiennent , commencent !par un chiffre ou une ponctuation, contiennent des espaces, ressemblent à des références de cellule de feuille de calcul, représentent des valeurs true ou false localisées, ou utilisez des noms réservés tels que Author, Createdou Description.
Créer une colonne
Créez une colonne sur le conteneur avant d’écrire des valeurs de champ sur des fichiers.
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
}
}
La demande de création ne prend pas en charge typeet le texte maxLength doit être inférieur ou égal à 255.
Remarque
Depuis janvier 2026, les API de colonne de conteneur (lister, créer, mettre à jour, supprimer des colonnes) sont également en disponibilité générale sur le point de terminaison Microsoft Graph v1.0 . Vous pouvez remplacer par /beta//v1.0/ dans les requêtes de colonne ci-dessous. Le point de terminaison bêta reste disponible.
Gérer les colonnes
Utilisez l’ID de colonne retourné par l’opération de création ou de liste.
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}
Corriger les propriétés prises en charge lorsque le schéma change. Vous pouvez mettre à jour n’importe quelle propriété d’une colonne, à l’exception de la id propriété .
{
"required": true,
"hidden": false,
"description": "This is my new column description"
}
Lire et écrire des métadonnées de fichier
Les valeurs de champ sont stockées dans les champs d’élément de liste de l’élément de lecteur. Lisez tous les champs ou sélectionnez ceux dont votre interface utilisateur a besoin.
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
Corriger les valeurs des champs pour mettre à jour les métadonnées. Utilisez null pour effacer une valeur de champ lorsque la colonne autorise des valeurs vides.
PATCH https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
Content-Type: application/json
{
"Color": "Fuchsia",
"Quantity": 934
}
{
"Color": null
}
Interroger des fichiers par métadonnées
Utilisez les options de requête OData sur des colonnes personnalisées lorsque vous avez besoin d’un filtrage ou d’un classement structuré à l’intérieur d’un lecteur de conteneur.
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)
Utilisez $expand=listitem($expand=fields) lorsque le résultat a besoin de valeurs de champ dans la réponse. Créez des colonnes indexées pour les filtres à cardinalité élevée que votre application exécute fréquemment.
Pour effectuer une recherche en texte intégral dans des conteneurs et des métadonnées personnalisées (à l’aide du OWSTEXT suffixe de propriété), consultez Rechercher des conteneurs et des fichiers. Utilisez OData $filter pour les requêtes structurées à l’intérieur d’un seul lecteur de conteneur ; utilisez la recherche de requêtes de texte libre sur de nombreux conteneurs.
Maintenir la cohérence du schéma
Créez les colonnes requises lors de l’approvisionnement de conteneurs. Stockez la version de schéma attendue dans vos données d’application et exécutez des migrations lorsque de nouvelles colonnes sont introduites. Évitez de supprimer des colonnes jusqu’à ce que vous sachiez qu’aucun flux de travail, requête, exportation ou expérience de recherche ne dépend de leurs valeurs.