ChartCollection: addChartCollection: add

Namespace: microsoft.graphNamespace: microsoft.graph

Cria um novo gráfico.Creates a new chart.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Files.ReadWriteFiles.ReadWrite
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP request

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

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Workbook-Session-IdWorkbook-Session-Id ID de sessão de pasta de trabalho que determina se as alterações são persistentes ou não. Opcional.Workbook session Id that determines if changes are persisted or not. Optional.

Corpo da solicitaçãoRequest body

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.In the request body, provide a JSON object with the following parameters.

ParâmetroParameter TipoType DescriçãoDescription
typetype stringstring Representa o tipo de um gráfico.Represents the type of a chart. Os valores possíveis são: ColumnClustered, ColumnStacked, ColumnStacked100, BarClustered, BarStacked, BarStacked100, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, etc..The possible values are: ColumnClustered, ColumnStacked, ColumnStacked100, BarClustered, BarStacked, BarStacked100, LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100, PieOfPie, etc..
sourceDatasourceData JsonJson O objeto Range correspondente aos dados de origem.The Range object corresponding to the source data.
seriesByseriesBy stringstring Opcional.Optional. Especifica a forma como as colunas ou linhas são usadas como série de dados no gráfico.Specifies the way columns or rows are used as data series on the chart. Os valores possíveis são: Auto, Columns, Rows.The possible values are: Auto, Columns, Rows.

RespostaResponse

Se bem-sucedido, este método retorna 200 OK o código de resposta e o objeto WorkbookChart no corpo da resposta.If successful, this method returns 200 OK response code and WorkbookChart object in the response body.

ExemploExample

Eis um exemplo de como chamar esta API.Here is an example of how to call this API.

SolicitaçãoRequest

Este é um exemplo da solicitação.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"
}
RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.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
}