Chart: setPositionChart: setPosition

Espace de noms: microsoft.graphNamespace: microsoft.graph

Positionne le graphique par rapport aux cellules dans la feuille de calcul.Positions the chart relative to cells on the worksheet.

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

POST /workbook/worksheets/{id|name}/charts/{name}/setPosition

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.

Corps de la demandeRequest body

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
startCellstartCell JsonJson Cellule de début. Il s’agit de l’emplacement où le graphique sera déplacé. La cellule de début est la cellule supérieure gauche ou supérieure droite, selon les paramètres d’affichage droite-gauche définis par l’utilisateur.The start cell. This is where the chart will be moved to. The start cell is the top-left or top-right cell, depending on the user's right-to-left display settings.
endCellendCell JsonJson Facultatif. Cellule de fin. Si une valeur est indiquée, la largeur et la hauteur du graphique seront définies de manière à couvrir entièrement cette cellule/plage.Optional. The end cell. If specified, the chart's width and height will be set to fully cover up this cell/range.

RéponseResponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK. Elle ne renvoie rien dans le corps de la réponse.If successful, this method returns 200 OK response code. It does not return anything 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.

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

{
  "startCell": "startCell-value",
  "endCell": "endCell-value"
}
RéponseResponse

Voici un exemple de réponse.Here is an example of the response.

HTTP/1.1 200 OK