driveItem: versión preliminar

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.