Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Use esta API para recuperar os conteúdos de um item em um formato específico. Nem todos os arquivos podem ser convertidos em todos os formatos.
Para baixar o item no formato original, confira Baixar o conteúdo de um item.
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) | Files.Read | Files. Read.All, Files. ReadWrite, Files. ReadWrite.All |
| 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
GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}
Parâmetros de consulta
| Parâmetro | Tipo | Descrição |
|---|---|---|
| formato | Cadeia de caracteres | Especifique o formato em que o conteúdo do item deve ser baixado. |
| height | Int32 | A altura pretendida da imagem convertida em píxeis. Necessário quando format=jpg. |
| width | Int32 | A largura pretendida da imagem convertida em píxeis. Necessário quando format=jpg. |
Opções de formato
Os seguintes valores são válidos para o parâmetro format:
| Valor de format | Descrição | Extensões de origem com suporte |
|---|---|---|
| jpg | Converte o item em formato JPG. | 3g2, 3gp, 3gp2, 3gpp, 3mf, ai, arw, asf, avi, bas, bash, bat, bmp, c, cbl, cmd, cool, cpp, cr2, crw, cs, css, csv, cur, dcm, dcm30, dic, dicm, dicom, dng, doc, docx, dwg, eml, epi, eps, epsf, epsi, epub, erf, fbx, fppx, gif, glb, h, hcp, heic, heif, htm, html, ico, icon, java, jfif, jpeg, jpg, js, json, key, log, m2ts, m4a, m4v, markdown, md, mef, mov, movie, mp3, mp4, mp4v, mrw, msg, mts, nef, nrw, numbers, obj, odp, odt, ogg, orf, pages, pano, pdf, pef, php, pict, pl, ply, png, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, ps, ps1, psb, psd, py, raw, rb, rtf, rw1, rw2, sh, sketch, sql, sr2, stl, tif, tiff, ts, txt, vb, webm, wma, wmv, xaml, xbm, xcf, xd, xml, xpm, yaml, yml |
| Converte o item em formato PDF. | doc, docx, dot, dotx, dotm, dsn, dwg, eml, epub, fluidframework, form, htm, html, loop, loot, markdown, md, msg, note, odp, ods, odt, page, pps, ppsx, ppt, pptx, pulse, rtf, task, tif, tiff, wbtx, whiteboard, xls, xlsm, xlsx | |
| HTML | Converte o item em formato HTML. | ciclo, fluido, wbtx, quadro |
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| if-none-match | Cadeia de caracteres. Se este cabeçalho de solicitação estiver incluso e a eTag (ou cTag) fornecida corresponder à marca atual do arquivo, uma resposta HTTP 304 Not Modified será exibida. |
Exemplo
Solicitação
O exemplo a seguir mostra uma solicitação.
GET /me/drive/items/{item-id}/content?format={format}
Resposta
O exemplo a seguir mostra a resposta. Devolve um 302 Found redirecionamento de resposta para um URL de transferência pré-autenticado para o ficheiro convertido.
Para baixar o arquivo convertido, seu aplicativo deve seguir o cabeçalho Location na resposta.
Os URLs pré-autenticados são válidos apenas por um curto período de tempo (alguns minutos) e não necessitam de um Authorization cabeçalho para aceder.
HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi
Respostas de erros
Para obter mais informações sobre como os erros são devolvidos, veja Respostas de erros.