Téléchargement d’un fichier dans un autre format
Utilisez cette API pour récupérer le contenu d’un élément dans un format spécifique. Tous les fichiers ne peuvent pas être convertis dans tous les formats.
Pour télécharger l’élément sous son format d’origine, consultez la rubrique Télécharger le contenu d’un élément.
Conditions préalables
Pour appeler cette API, l’utilisateur doit procurer à l’application une autorisation d’accès en lecture pour le fichier à convertir.
Requête HTTP
GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}
En-têtes de demande facultatifs
| Nom | Valeur | Description |
|---|---|---|
| if-none-match | String | Si cet en-tête de demande est inclus et que l’eTag (ou cTag) fourni correspond à l’identité actuelle sur le fichier, une réponse HTTP 304 Not Modified est renvoyée. |
Paramètres de chaîne de requête
| Nom | Valeur | Description |
|---|---|---|
| format | chaîne | Spécifiez le format sous lequel le contenu de l’élément doit être téléchargé. |
Options de mise en forme
| Valeur | Description | Extensions source prises en charge |
|---|---|---|
| glb | Convertit l’élément au format GLB | cool, FBX, obj, pli, STL, 3mf |
| html | Convertit l’élément au format HTML | eml, md, msg |
| jpg | Convertit l’élément au format 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 |
| Convertit l’élément au format PDF | doc, docx, epub, eml, htm, html, md, msg, odp, ods, odt, pps, ppsx, ppt, pptx, rtf, tif, tiff, xls, xlsm, xlsx |
Exemple
GET /drive/items/{item-id}/content?format={format}
Réponse
Renvoie une réponse 302 Found qui redirige vers une URL de téléchargement préalablement authentifiée pour le fichier converti.
Pour télécharger le fichier converti, votre application doit suivre l’en-tête Location dans la réponse.
Les URL préalablement authentifiées ne sont valides que pour une courte période de temps (quelques minutes) et ne nécessitent pas d’en-tête Authorization pour l’accès.
HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi
Réponses d’erreur
Pour plus d’informations sur la façon dont les erreurs sont renvoyées, voir Réponses d’erreur.
Problèmes connus relatifs à la conversion HTML au format PDF
(1) Pour des performances optimales, vérifiez que le code HTML respecte la norme XHTML. Le composant ne fonctionnera pas aussi bien que les navigateurs web modernes pour analyser correctement un code HTML mal formé. Par exemple, si une ligne de table ne contient pas de balise de fin ().
(2) Dans certains cas, les caractères non latins ne s’affichent pas comme prévu. Par exemple, un ensemble de polices prédéfinies est installé pour les langues telles que le chinois, mais si le code HTML n’indique pas une police couramment connue, le composant ne parvient pas, dans certaines circonstances, à déterminer la police à utiliser et le caractère ne s’affiche pas correctement.
(3) Chaque fichier HTML est remplacé par un fichier PDF de taille A4. Lorsqu’une seule largeur de ligne HTML est supérieure à la largeur de la taille A4, la ligne est tronquée dans le rendu PDF.