driveItem: versión preliminar

  • Artículo

Espacio de nombres: microsoft.graph

Esta acción le permite obtener una dirección URL insertable de corta duración para un elemento con el fin de representar una vista previa temporal.

Si desea obtener vínculos incrustables de larga duración, use createLink API en su lugar.

Nota: La acción de vista previa solo está disponible actualmente en SharePoint y OneDrive para la Empresa.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ✅ ✅ ✅

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitud HTTP

POST /drives/{driveId}/items/{itemId}/preview
POST /groups/{groupId}/drive/items/{itemId}/preview
POST /me/drive/items/{itemId}/preview
POST /sites/{siteId}/drive/items/{itemId}/preview
POST /users/{userId}/drive/items/{itemId}/preview
POST /shares/{shareId}/driveItem/preview

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

El cuerpo de la solicitud define las propiedades de la dirección URL incrustable que la aplicación está solicitando. La solicitud debe ser un objeto JSON con las siguientes propiedades.

Nombre Tipo Descripción
page cadena/número Opcional. Número de página del documento al que empezar, si procede. Se especifica como cadena para casos de uso futuros en torno a tipos de archivo como ZIP.
zoom número Opcional. Nivel de zoom en el que empezar, si procede.

Respuesta

{
    "getUrl": "https://www.onedrive.com/embed?foo=bar&bar=baz",
    "postParameters": "param1=value&param2=another%20value",
    "postUrl": "https://www.onedrive.com/embed_by_post"
}

La respuesta será un objeto JSON que contiene las siguientes propiedades:

Nombre Tipo Descripción
Geturl string Dirección URL adecuada para la inserción mediante HTTP GET (iframes, etc.)
postUrl string Dirección URL adecuada para la inserción mediante HTTP POST (entrada de formulario, JS, etc.)
postParameters string Parámetros POST que se van a incluir si se usa postUrl

GetUrl, postUrl o ambos pueden devolverse en función del estado actual de compatibilidad con la inserción para las opciones especificadas.

postParameters es una cadena con application/x-www-form-urlencodedformato , y si se realiza una operación POST en postUrl, el tipo de contenido debe establecerse en consecuencia. Por ejemplo:

POST https://www.onedrive.com/embed_by_post
Content-Type: application/x-www-form-urlencoded

param1=value&param2=another%20value

Página/zoom

Es posible que las opciones "página" y "zoom" no estén disponibles para todas las aplicaciones en versión preliminar, pero se aplicarán si la aplicación en versión preliminar la admite.