Mettre à jour un graphiqueUpdate chart

Espace de noms: microsoft.graphNamespace: microsoft.graph

Mettre à jour les propriétés d’un objet Graphique.Update the properties of chart object.

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

PATCH /workbook/worksheets/{id|name}/charts/{name}

En-têtes de demande facultatifsOptional request 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.

Corps de la demandeRequest body

Dans le corps de la demande, fournissez les valeurs pour les champs appropriés qui doivent être mis à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conserveront leurs valeurs précédentes ou seront recalculées en fonction des modifications apportées à d’autres valeurs des propriétés. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas changé.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

PropriétéProperty TypeType DescriptionDescription
heightheight Doubledouble Représente la hauteur, exprimée en points, de l’objet de graphique.Represents the height, in points, of the chart object.
leftleft Doubledouble Distance, en points, entre le côté gauche du graphique et l’origine de la feuille de calcul.The distance, in points, from the left side of the chart to the worksheet origin.
namename stringstring Représente le nom d’un objet de graphique.Represents the name of a chart object.
toptop Doubledouble Représente la distance, en points, entre le bord supérieur de l’objet et la partie supérieure de la ligne 1 (sur une feuille de calcul) ou le haut de la zone de graphique (sur un graphique).Represents the distance, in points, from the top edge of the object to the top of row 1 (on a worksheet) or the top of the chart area (on a chart).
widthwidth Doubledouble Représente la largeur, en points, de l’objet de graphique.Represents the width, in points, of the chart object.

RéponseResponse

Si elle réussit, cette méthode renvoie un 200 OK Code de réponse et un objet WorkbookChart mis à jour dans le corps de la réponse.If successful, this method returns a 200 OK response code and updated WorkbookChart object in the response body.

ExempleExample

DemandeRequest

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

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}
Content-type: application/json
Content-length: 52

{
  "height": 99,
  "left": 99
}
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
Content-length: 52

{
  "id": "id-value",
  "height": 99,
  "left": 99
}