driveItem: VorschaudriveItem: preview

Namespace: microsoft.graphNamespace: microsoft.graph

Mit dieser Aktion können Sie eine kurzlebige Einbettungs-URL für ein Element abrufen, um eine temporäre Vorschau zu rendern.This action allows you to obtain a short-lived embeddable URL for an item in order to render a temporary preview.

Wenn Sie langlebige integrierbare Links erhalten möchten, verwenden Sie stattdessen die CreateLink -API.If you want to obtain long-lived embeddable links, use the createLink API instead.

Hinweis: Die Vorschau Aktion ist derzeit nur in SharePoint und OneDrive für Unternehmen verfügbar.Note: The preview action is currently only available on SharePoint and OneDrive for Business.

BerechtigungenPermissions

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.AllFiles.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-AnforderungHTTP request

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

AnforderungstextRequest body

Der Text der Anforderung definiert die Eigenschaften der Einbettungs-URL, die von der Anwendung angefordert wird.The body of the request defines properties of the embeddable URL your application is requesting. Bei der Anforderung sollte es sich um ein JSON-Objekt mit folgenden Eigenschaften handeln:The request should be a JSON object with the following properties.

NameName TypType BeschreibungDescription
pagepage Zeichenfolge/Zahlstring/number Optional.Optional. Seitenzahl des zu beginnenden Dokuments, falls zutreffend.Page number of document to start at, if applicable. Als Zeichenfolge für zukünftige Anwendungsfälle um Dateitypen wie ZIP angegeben.Specified as string for future use cases around file types such as ZIP.
Zoomzoom numbernumber Optional.Optional. Vergrößerungsstufe, wenn zutreffend, um zu beginnen.Zoom level to start at, if applicable.

AntwortResponse

{
    "getUrl": "https://www.onedrive.com/embed?foo=bar&bar=baz",
    "postParameters": "param1=value&param2=another%20value",
    "postUrl": "https://www.onedrive.com/embed_by_post"
}

Die Antwort ist ein JSON-Objekt, das die folgenden Eigenschaften enthält:The response will be a JSON object containing the following properties:

NameName TypType BeschreibungDescription
getURLgetUrl stringstring URL, die für das Einbetten mit HTTP Get geeignet ist (IFrames usw.)URL suitable for embedding using HTTP GET (iframes, etc.)
postUrlpostUrl stringstring URL, die für das Einbetten mit HTTP-Post geeignet ist (Formular Beitrag, JS, usw.)URL suitable for embedding using HTTP POST (form post, JS, etc.)
postparameterpostParameters stringstring Post-Parameter einschließen, wenn mit haltunglPOST parameters to include if using postUrl

Je nach aktuellem Status der Einbettungs Unterstützung für die angegebenen Optionen wird möglicherweise entweder getURL, Posel oder beides zurückgegeben.Either getUrl, postUrl, or both might be returned depending on the current state of embed support for the specified options.

postparameters ist eine Zeichenfolge, die als formatiert ist application/x-www-form-urlencoded , und wenn ein Beitrag in der Haltungs Ausführung ausgeführt wird, sollte der Inhaltstyp entsprechend festgelegt werden.postParameters is a string formatted as application/x-www-form-urlencoded, and if performing a POST to the postUrl the content-type should be set accordingly. Beispiel:For example:

POST https://www.onedrive.com/embed_by_post
Content-Type: application/x-www-form-urlencoded

param1=value&param2=another%20value

Seite/ZoomPage/zoom

Die Optionen "Seite" und "Zoom" sind möglicherweise nicht für alle Vorschau-apps verfügbar, werden jedoch angewendet, wenn Sie von der Vorschau-App unterstützt werden.The 'page' and 'zoom' options may not be available for all preview apps, but will be applied if the preview app supports it.