driveItem: Vorschau

Namespace: microsoft.graph

Mit dieser Aktion können Sie eine kurzlebige einbettbare URL für ein Element abrufen, um eine temporäre Vorschau zu rendern.

Wenn Sie langlebige einbettbare Links abrufen möchten, verwenden Sie stattdessen die [createLink-API.][]

Hinweis: Die Vorschauaktion ist derzeit nur auf SharePoint und OneDrive for Business verfügbar.

Berechtigungen

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.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Files.Read, Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-Anforderung

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

Anforderungstext

Der Textkörper der Anforderung definiert die Eigenschaften der einbettbaren URL, die Ihre Anwendung anfordert. Bei der Anforderung sollte es sich um ein JSON-Objekt mit folgenden Eigenschaften handeln:

Name	Typ	Beschreibung
page	Zeichenfolge/Zahl	Optional. Seitenzahl des Dokuments, mit dem ggf. begonnen werden soll. Wird als Zeichenfolge für zukünftige Anwendungsfälle in Bezug auf Dateitypen wie ZIP angegeben.
Zoom	number	Optional. Zoomfaktor, um ggf. zu beginnen.

Antwort

{
    "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:

Name	Typ	Beschreibung
Geturl	Zeichenfolge	URL geeignet zum Einbetten mit HTTP GET (iframes usw.)
postUrl	Zeichenfolge	URL geeignet zum Einbetten mit HTTP POST (Formularbeitrag, JS usw.)
postParameters	Zeichenfolge	POST-Parameter, die bei Verwendung von postUrl eingeschlossen werden sollen

Je nach aktuellem Status der Einbettungsunterstützung für die angegebenen Optionen können entweder getUrl, postUrl oder beide zurückgegeben werden.

postParameters ist eine Zeichenfolge, die als formatiert application/x-www-form-urlencoded ist, und wenn Sie einen POST für postUrl ausführen, sollte der Inhaltstyp entsprechend festgelegt werden. Beispiel:

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

param1=value&param2=another%20value

Seite/Zoom

Die Optionen "Seite" und "Zoom" sind möglicherweise nicht für alle Vorschau-Apps verfügbar, werden jedoch angewendet, wenn die Vorschau-App dies unterstützt.