driveItem: Vorschau

  • Artikel

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 für SharePoint und OneDrive for Business verfügbar.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ✅

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt 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

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Der Text der Anforderung definiert 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, bei dem begonnen werden soll, falls zutreffend. Wird als Zeichenfolge für zukünftige Anwendungsfälle für Dateitypen wie ZIP angegeben.
Zoom number Optional. Zoomfaktor, der ggf. beginnen soll.

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 string URL, die für die Einbettung mit HTTP GET (iframes usw.) geeignet ist
postUrl string URL, die für die Einbettung mit HTTP POST (Formularpost, JS usw.) geeignet ist
postParameters string EINzufügende POST-Parameter bei Verwendung von postUrl

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 application/x-www-form-urlencodedformatiert ist, und wenn ein POST an die postUrl ausgeführt wird, sollte der Inhaltstyp entsprechend festgelegt werden. Zum 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 sie unterstützt.