Compartilhar via


driveItem: versão prévia

Namespace: microsoft.graph

Essa ação permite obter uma URL inserida de curta duração para um item para renderizar uma visualização temporária.

Se você quiser obter links inseriveis de longa duração, use a API createLink .

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

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
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

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 da solicitação define as propriedades da URL inserida que seu aplicativo está solicitando. A solicitação deve ser um objeto JSON com as seguintes propriedades.

Nome Tipo Descrição
page cadeia de caracteres/número Opcional. Número de página do documento a ser iniciado, se aplicável. Especificado como cadeia de caracteres para casos de uso futuros em torno de tipos de arquivo, como ZIP.
zoom number Opcional. Nível de zoom a ser iniciado, 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 cadeia de caracteres URL adequada para inserção usando HTTP GET (iframes etc.)
postUrl cadeia de caracteres URL adequada para inserção usando HTTP POST (postagem de formulário, JS etc.)
postParameters string Parâmetros POST a serem incluídos se usar postUrl

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

postParameters é uma cadeia de caracteres formatada como application/x-www-form-urlencoded, e se executar um POST para o postUrl, o tipo de conteúdo deverá ser 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 versão prévia, mas serão aplicadas se o aplicativo de visualização der suporte a ele.