ChartCollection: addChartCollection: add

Espace de noms: microsoft.graphNamespace: microsoft.graph

Crée un graphique.Creates a new chart.

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/add

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
typetype stringstring Représente le type d’un graphique.Represents the type of a chart. Les valeurs possibles sont les suivantes : ColumnClustered , ColumnStacked ,, ColumnStacked100 BarClustered ,,, BarStacked BarStacked100 LineStacked , LineStacked100 LineMarkers LineMarkersStacked LineMarkersStacked100 PieOfPie etc. ,,,,, et.The possible values are: ColumnClustered, ColumnStacked, ColumnStacked100, BarClustered, BarStacked, BarStacked100, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, etc..
sourceDatasourceData JsonJson Objet Range correspondant aux données source.The Range object corresponding to the source data.
seriesByseriesBy stringstring Facultatif.Optional. Spécifie la façon dont les colonnes ou les lignes sont utilisées comme séries de données sur le graphique.Specifies the way columns or rows are used as data series on the chart. Les valeurs possibles sont Auto, Columns, Rows.The possible values are: Auto, Columns, Rows.

RéponseResponse

Si elle réussit, cette méthode renvoie 200 OK un code de réponse et un objet WorkbookChart dans le corps de la réponse.If successful, this method returns 200 OK response code and WorkbookChart object 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/add
Content-type: application/json
Content-length: 94

{
  "type": "ColumnStacked",
  "sourceData": "A1:B1",
  "seriesBy": "Auto"
}
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
}