Diagramm: Bild

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Rendert das Diagramm als base64-codiertes Bild durch Skalierung, um es an die angegebenen Maße anzupassen.

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.ReadWrite
Delegiert (persönliches Microsoft-Konto)	Files.ReadWrite
Anwendung	Nicht unterstützt

HTTP-Anforderung

GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich.
Arbeitsmappensitzungs-ID	Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden. Optional.

Anforderungstext

Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.

Parameter	Typ	Beschreibung
height	number	Optional. Die gewünschte Höhe des resultierenden Bilds.
width	number	Optional. Die gewünschte Breite des resultierenden Bilds.
fittingMode	string	Optional. Die Methode, die verwendet wird, um das Diagramm auf die angegebenen Maße zu skalieren (wenn Höhe und Breite festgelegt sind). Mögliche Werte: Fit, FitAndCenter, Fill.

Antwort

Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK und eine base64-Bildzeichenfolge im Antworttext zurückgegeben.

Beispiel

Nachfolgend sehen Sie ein Beispiel dafür, wie diese API aufgerufen wird.

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')

Antwort

Hier ist ein Beispiel für die Antwort. Hinweis: Das hier gezeigte Antwortobjekt wird möglicherweise zur besseren Lesbarkeit verkürzt.

HTTP/1.1 200 OK
Content-type: application/json

{
"value" : "base-64 chart image string"
}

Verwendung

Sie können die Base64-Zeichenfolge innerhalb eines HTML-Bild-Tags anzeigen: <img src="data:image/png;base64,{base-64 chart image string}/>.

Verwenden Sie für das Standardverhalten Image(width=0,height=0,fittingMode='fit'). Hier ist ein Beispiel für ein Diagrammbild, das mit den standardmäßigen Parametern zurückgegeben wird.

Wenn Sie die Anzeige des Bilds anpassen möchten, geben Sie eine Höhe, Breite und einen Anpassmodus an. So sieht dasselbe Diagrammbild aus, wenn Sie es mit diesen Parametern abrufen: Image(width=500,height=500,fittingMode='Fill').