Herunterladen einer Datei in einem anderen FormatDownload a file in another format

Namespace: microsoft.graphNamespace: microsoft.graph

Mithilfe dieser API können Sie den Inhalt eines Elements in einem bestimmten Format abrufen.Use this API to retrieve the contents of an item in a specific format. Nicht jede Datei kann in sämtliche Formate konvertiert werden.Not all files can be converted into all formats.

Wie Sie das Element in seinem ursprünglichen Format herunterladen können, erfahren Sie unter Herunterladen des Inhalts von OneDrive-Elementen.To download the item in its original format, see download an item's contents.

VoraussetzungenPrerequisites

Damit diese API aufgerufen werden kann, muss der Benutzer der Anwendung Lesezugriff auf die Datei gewährt haben, die von der App konvertiert werden soll.To call this API, the user must have granted the application read access to the file the app wishes to convert.

HTTP-AnforderungHTTP request

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

AbfrageparameterQuery parameters

ParameterParameter TypType BeschreibungDescription
formatformat stringstring Hier geben Sie das Format an, in dem der Elementinhalt heruntergeladen werden soll.Specify the format the item's content should be downloaded as.

FormatoptionenFormat options

Die folgenden Werte sind für den Parameter format gültig:The following values are valid for the format parameter:

Format-WertFormat value BeschreibungDescription Unterstützte QuellerweiterungenSupported source extensions
pdfpdf Konvertiert das Element ins PDF-Format.Converts the item into PDF format. CSV, DOC, DOCX, ODP, ODS, ODT, POT, POTM, POTX, PPS, PPSX, PPSXM, PPT, PPTM, PPTX, RTF, XLS, XLSXcsv, doc, docx, odp, ods, odt, pot, potm, potx, pps, ppsx, ppsxm, ppt, pptm, pptx, rtf, xls, xlsx

Optionale AnforderungsheaderOptional request headers

NameName WertValue BeschreibungDescription
if-none-matchif-none-match ZeichenfolgeString Wenn dieser Anforderungsheader enthalten ist und das angegebene eTag (oder cTag) mit dem aktuellen Tag in der Datei übereinstimmt, wird die Antwort HTTP 304 Not Modified zurückgegeben.If this request header is included and the eTag (or cTag) provided matches the current tag on the file, an HTTP 304 Not Modified response is returned.

BeispielExample

GET /me/drive/items/{item-id}/content?format={format}

AntwortResponse

Die Methode gibt eine Antwort 302 Found zurück, die auf eine vorab authentifizierte URL zum Download der konvertierten Datei umleitet.Returns a 302 Found response redirecting to a pre-authenticated download URL for the converted file.

Um die konvertierte Datei herunterladen zu können, muss die App den Location-Header in der Antwort aufrufen.To download the converted file, your app must follow the Location header in the response.

Vorab authentifizierte URLs sind nur für eine kurze Zeit gültig (einige Minuten) und erfordern für den Zugriff keinen Authorization-Header.Pre-authenticated URLs are only valid for a short period of time (a few minutes) and do not require an Authorization header to access.

HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi

FehlerantwortenError responses

Weitere Informationen dazu, wie Fehler zurückgegeben werden, finden Sie im unter Fehlerantworten.See Error Responses for more information about how errors are returned.