Partager via


Téléchargement d’un fichier dans un autre format

Espace de noms: microsoft.graph

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 relative au téléchargement du contenu d’un élément.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All
Application Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

Requête HTTP

GET /drive/items/{item-id}/content?format={format}
GET /drive/root:/{path and filename}:/content?format={format}

Paramètres de requête

Paramètre Type 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

Les valeurs suivantes sont valides pour ce paramètre format :

Valeur de mise en forme Description Extensions source prises en charge
pdf Convertit l’élément au format PDF. csv, doc, docx, odp, ods, odt, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, rtf, xls, xlsx
html Convertit l’élément au format HTML. loop, fluid, wbtx

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
if-none-match Chaîne. 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.

Exemple

GET /me/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.