Compartilhar via

driveItem: pré-visualização

Namespace: microsoft.graph

Esta ação permite-lhe obter um URL incorporado de curta duração para um item para compor uma pré-visualização temporária.

Se quiser obter ligações incorporáveis de longa duração, utilize a API createLink .

Observação

Atualmente, a ação de pré-visualização só está disponível no SharePoint e OneDrive for Business.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

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

Observação

O SharePoint Embedded requer a FileStorageContainer.Selected permissão para aceder ao conteúdo do contentor. Esta permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, a sua aplicação tem de ter as permissões de tipo de contentor necessárias para chamar esta API. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.

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

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

O corpo do pedido define as propriedades do URL incorporado que a sua aplicação está a pedir. A solicitação deve ser um objeto JSON com as seguintes propriedades.

Nome Tipo Descrição
page cadeia/número Opcional. Número de página do documento a iniciar, se aplicável. Especificado como cadeia para casos de utilização futuros em torno de tipos de ficheiro, 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 que contém as seguintes propriedades:

Nome Tipo Descrição
getUrl string URL adequado para incorporação com HTTP GET (iframes, etc.)
postUrl string URL adequado para incorporação com HTTP POST (post de formulário, JS, etc.)
postParameters string Parâmetros POST a incluir se utilizar postUrl

GetUrl, postUrl ou ambos podem ser devolvidos consoante o estado atual do suporte de incorporação para as opções especificadas.

postParameters é uma cadeia formatada como application/x-www-form-urlencodede, se efetuar um POST no postUrl, o tipo de conteúdo deve ser definido em conformidade. 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 "página" e "zoom" podem não estar disponíveis para todas as aplicações de pré-visualização, mas serão aplicadas se a aplicação de pré-visualização o suportar.

  • Last updated on