driveItem: versión preliminar

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Esta acción le permite obtener direcciones URL insertables 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

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
espectador	string	Opcional. Versión preliminar de la aplicación que se va a usar. onedrive o office. Si es null, se elegirá automáticamente un visor adecuado.
sin cromo	Booleano	Opcional. Si true es (valor predeterminado), la vista incrustada no incluirá ningún control.
allowEdit	Booleano	Opcional. Si truees , el archivo se puede editar desde la interfaz de usuario incrustada.
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, etcetera).
postUrl	string	Dirección URL adecuada para la inserción mediante HTTP POST (form post, JS, etcetera).
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

Espectadores

Nota: Este parámetro está en desuso y no estará disponible en el punto de conexión v1.0.

Se permiten los siguientes valores para el parámetro viewer .

Valor del tipo	Descripción
(null)	Elige una aplicación adecuada para representar el archivo. En la mayoría de los casos, se usará la onedrive vista previa, pero puede variar según el tipo de archivo.
onedrive	Use la aplicación de vista previa de OneDrive para representar el archivo.
office	Use la versión web de Office para representar el archivo. Solo es válido para documentos de Office.

Chrome frente a chromeless

Nota: Este parámetro está en desuso y no estará disponible en el punto de conexión v1.0.

Si chromeless es true, la vista previa será una representación sin sistema operativo del archivo. De lo contrario, puede haber barras de herramientas o botones adicionales para interactuar con el documento o la vista.

Ver o editar

Nota: Este parámetro está en desuso y no estará disponible en el punto de conexión v1.0.

Si allowEdit es true, la interacción del usuario con la vista previa incrustada puede modificar el documento. Es posible que esta funcionalidad no esté disponible para todos los tipos de archivo o aplicaciones en versión preliminar.

Página/zoom

Es page posible que las opciones 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 lo admite.