Chart: ImageChart: Image

Espace de noms: microsoft.graphNamespace: microsoft.graph

Affiche le graphique sous forme d’image codée en Base64 ajustée aux dimensions spécifiées.Renders the chart as a base64-encoded image by scaling the chart to fit the specified dimensions.

AutorisationsPermissions

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Type d’autorisationPermission type Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)Permissions (from least to most privileged)
Déléguée (compte professionnel ou scolaire)Delegated (work or school account) Files.ReadWriteFiles.ReadWrite
Déléguée (compte Microsoft personnel)Delegated (personal Microsoft account) Non prise en charge.Not supported.
ApplicationApplication Non prise en charge.Not supported.

Requête HTTPHTTP request

GET /workbook/worksheets/{id|name}/charts/{name}/image
GET /workbook/worksheets/{id|name}/charts/{name}/image(width=640)
GET /workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480)
GET /workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')

En-têtes de demandeRequest headers

NomName DescriptionDescription
AutorisationAuthorization Porteur {token}. Obligatoire.Bearer {token}. Required.
Workbook-Session-IdWorkbook-Session-Id ID de session d’un classeur qui détermine si les modifications sont permanentes ou non. Facultatif.Workbook session Id that determines if changes are persisted or not. Optional.

Paramètres du chemin d’accèsPath parameters

Dans le corps de la demande, indiquez un objet JSON avec les paramètres suivants.In the request body, provide a JSON object with the following parameters.

ParamètreParameter TypeType DescriptionDescription
heightheight Int32Int32 Hauteur souhaitée de l’image produite.The desired height of the resulting image. Facultatif.Optional.
widthwidth Int32Int32 Largeur souhaitée de l’image produite.The desired width of the resulting image. Facultatif.Optional.
fittingModefittingMode stringstring Méthode utilisée pour faire monter en taille le graphique aux dimensions spécifiées (si la hauteur et la largeur sont définies). "The method used to scale the chart to the specified dimensions (if both height and width are set)." Les valeurs possibles sont Fit, FitAndCenter, Fill.The possible values are: Fit, FitAndCenter, Fill.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et une chaîne d’image en base 64 dans le corps de la réponse.If successful, this method returns 200 OK response code and base-64 image string in the response body.

ExempleExample

Voici comment vous pouvez appeler cette API.Here is an example of how to call this API.

DemandeRequest

Voici un exemple de demande.Here is an example of the request.

GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
RéponseResponse

Voici un exemple de la réponse. Remarque : L’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json;odata.metadata=minimal;odata.streaming=true

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

UtilisationUsage

Vous pouvez afficher la chaîne en base 64 à l’intérieur d’une balise d’image HTML : <img src="data:image/png;base64,{base-64 chart image string}/>.You can display the base-64 string inside an HTML image tag: <img src="data:image/png;base64,{base-64 chart image string}/>.

Pour le comportement par défaut, utilisez Image(width=0,height=0,fittingMode='fit').For default behavior, use Image(width=0,height=0,fittingMode='fit'). Voici un exemple de l’image d’un graphique renvoyé avec les paramètres par défaut.Here is an example of a chart image returned with the default parameters.

Image de graphique Excel avec hauteur et largeur par défaut.

Si vous souhaitez personnaliser l’affichage de l’image, indiquez une hauteur, une largeur et un mode d’ajustement.If you want to customize the display of the image, specify a height, width, and a fitting mode. Voici à quoi ressemble la même image de graphique si vous la récupérez avec ces paramètres : Image(width=500,height=500,fittingMode='Fill').Here is what the same chart image looks like if you retrieve it with these parameters: Image(width=500,height=500,fittingMode='Fill').

Image de graphique Excel avec hauteur et largeur par défaut.