driveItem: visualização

Namespace: microsoft.graph

Essa ação permite que você obtenha uma URL in-loca de curta duração para um item para renderizar uma visualização temporária.

Se você quiser obter links inbeddáveis de longa duração, use a API createLink em vez disso.

Observação: No momento, a ação de visualização só está disponível SharePoint e OneDrive for Business.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Solicitação 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

Corpo da solicitação

O corpo da solicitação define propriedades da URL inbeddable que seu aplicativo está solicitando. A solicitação deve ser um objeto JSON com as seguintes propriedades.

Nome	Tipo	Descrição
page	string/number	Opcional. Número da página do documento a ser inicial, se aplicável. Especificado como cadeia de caracteres para casos futuros de uso em torno de tipos de arquivo, como ZIP.
zoom	number	Opcional. Nível de zoom para começar em, se aplicável.

Resposta

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

A resposta será um objeto JSON contendo as seguintes propriedades:

Name	Tipo	Descrição
getUrl	cadeia de caracteres	URL adequada para a incorporação usando HTTP GET (iframes, etc.)
postUrl	cadeia de caracteres	URL adequada para a incorporação usando HTTP POST (postagem de formulário, JS, etc.)
postParameters	cadeia de caracteres	Parâmetros POST a incluir se estiver usando postUrl

GetUrl, postUrl ou ambos podem ser retornados dependendo do estado atual do suporte de incorporar para as opções especificadas.

postParameters é uma cadeia de caracteres formatada como , e se executar um POST para o postUrl o tipo de conteúdo deve ser application/x-www-form-urlencoded definido de acordo. Por exemplo:

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

param1=value&param2=another%20value

Página/zoom

As opções 'page' e 'zoom' podem não estar disponíveis para todos os aplicativos de visualização, mas serão aplicadas se o aplicativo de visualização for compatível com ele.