Almacenar y consultar metadatos de contenedor

Se aplica a: Desarrollador

Use metadatos cuando la aplicación necesite campos estructurados en los archivos de un contenedor de SharePoint Embedded. Los metadatos se almacenan como columnas en y fileStorageContainer como valores de campo en los elementos de la unidad contenedora. La aplicación es responsable de crear y administrar el esquema de columna para cada instancia de contenedor. Para obtener la lista completa de propiedades de recursos de contenedor, consulte tipo de recurso fileStorageContainer.

Permisos y llamadores admitidos

Llame a las API de metadatos con un token de portador delegado o solo de aplicación. Use FileStorageContainer.Selected para las llamadas de aplicación y delegadas.

Los propietarios de contenedores pueden crear, actualizar y eliminar columnas. Los miembros del contenedor pueden leer y enumerar columnas.

Elegir tipos de columna

Los metadatos de SharePoint Embedded admiten estas propiedades de tipo de columna: boolean, choice, , dateTimecurrency, hyperlinkOrPicture, number, personOrGroupy text. También admite la configuración de columna como indexed, isDeletable, isSealed, name, readOnlyy type.

Los nombres de columna deben seguir las reglas de SharePoint. No use nombres que contengan !, comience con un dígito o signo de puntuación, contenga espacios, parezca referencias de celda de hoja de cálculo, represente valores verdaderos o falsos localizados o use nombres reservados como Author, Createdo Description.

Creación de una columna

Cree una columna en el contenedor antes de escribir valores de campo en los archivos.

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 solicitud de creación no admite typey el texto maxLength debe ser menor o igual que 255.

Nota:

A partir de enero de 2026, las API de columna de contenedor (lista, creación, actualización y eliminación de columnas) también están disponibles con carácter general en el punto de conexión de Microsoft Graph v1.0 . Puede reemplazar por /beta//v1.0/ en las solicitudes de columna siguientes. El punto de conexión beta permanece disponible.

Administrar columnas

Use el identificador de columna devuelto por la operación de creación o lista.

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}

Revise las propiedades admitidas cuando cambie el esquema. Puede actualizar cualquier propiedad de una columna excepto la id propiedad .

{
  "required": true,
  "hidden": false,
  "description": "This is my new column description"
}

Leer y escribir metadatos de archivo

Los valores de campo se almacenan en los campos de elemento de lista del elemento de unidad. Lea todos los campos o seleccione los que necesita la interfaz de usuario.

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

Aplicar revisiones a los valores de campo para actualizar los metadatos. Use null para borrar un valor de campo cuando la columna permita valores vacíos.

PATCH https://graph.microsoft.com/beta/drives/{drive-id}/items/{item-id}/listitem/fields
Content-Type: application/json

{
  "Color": "Fuchsia",
  "Quantity": 934
}

{
  "Color": null
}

Consulta de archivos por metadatos

Use las opciones de consulta de OData en columnas personalizadas cuando necesite filtrado estructurado o ordenación dentro de una unidad de contenedor.

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)

Use $expand=listitem($expand=fields) cuando el resultado necesite valores de campo en la respuesta. Cree columnas indizadas para filtros de alta cardinalidad que la aplicación ejecuta con frecuencia.

Para buscar texto completo entre contenedores y metadatos personalizados (con el OWSTEXT sufijo de propiedad), consulte Buscar contenedores y archivos. Use OData $filter para consultas estructuradas dentro de una única unidad de contenedor; use la búsqueda de consultas de texto libre en muchos contenedores.

Mantener coherente el esquema

Cree las columnas necesarias durante el aprovisionamiento de contenedores. Almacene la versión de esquema esperada en los datos de la aplicación y ejecute migraciones cuando se introduzcan nuevas columnas. Evite eliminar columnas hasta que no sepa que ningún flujo de trabajo, consultas, exportaciones o experiencias de búsqueda dependen de sus valores.

Pasos siguientes

  • Last updated on