Diagramm: Bild
Namespace: microsoft.graph
Rendert das Diagramm als base64-codiertes Bild durch Skalierung, um es an die angegebenen Maße anzupassen.
Berechtigungen
Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter 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) | Nicht unterstützt |
| Anwendung | Nicht unterstützt |
HTTP-Anforderung
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640)
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image(width=640)
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480)
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480)
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
Anforderungsheader
| Name | Beschreibung |
|---|---|
| Authorization | Bearer {token}. Erforderlich. |
| Arbeitsmappensitzungs-ID | Arbeitsmappensitzungs-ID, die bestimmt, ob Änderungen beibehalten werden. Optional. |
Pfadparameter
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an.
| Parameter | Typ | Beschreibung |
|---|---|---|
| height | Int32 | Die gewünschte Höhe des resultierenden Bilds. Optional. |
| width | Int32 | Die gewünschte Breite des resultierenden Bilds. Optional. |
| fittingMode | string | Die Methode, die verwendet wird, um das Diagramm auf die angegebenen Dimensionen zu skalieren (wenn sowohl Höhe als auch Breite festgelegt sind)." Die möglichen Werte sind: 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/v1.0/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt sein.
HTTP/1.1 200 OK
Content-type: application/json;odata.metadata=minimal;odata.streaming=true
{
"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').
