driveItem: vista previa

Espacio de nombres: microsoft.graph

Esta acción le permite obtener una dirección URL incrustable 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 la API createLink en su lugar.

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

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (cuenta personal de Microsoft) 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 está solicitando la aplicación. La solicitud debe ser un objeto JSON con las siguientes propiedades.

Nombre Tipo Descripción
page string/number Opcional. Número de página del documento que se iniciará en, si procede. Se especifica como cadena para futuros casos de uso en torno a tipos de archivo como ZIP.
zoom number Opcional. Nivel de zoom para empezar en, 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 contenga las siguientes propiedades:

Nombre Tipo Descripción
getUrl string Dirección URL adecuada para insertar mediante HTTP GET (iframes, etc.)
postUrl string Dirección URL adecuada para insertar mediante HTTP POST (publicación de formulario, JS, etc.)
postParameters string Parámetros POST que se incluirán si se usa postUrl

Es posible que getUrl, postUrl o ambos se devuelvan en función del estado actual de compatibilidad de inserción para las opciones especificadas.

postParameters es una cadena con el formato , y si se realiza un POST en postUrl, el tipo de contenido application/x-www-form-urlencoded 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 de vista previa, pero se aplicarán si la aplicación de vista previa lo admite.