Chart: Image

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor de versão.

Processa o gráfico como uma imagem codificada em base64, dimensionando o gráfico para se ajustar às dimensões especificadas.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Files.ReadWrite
Delegado (conta pessoal da Microsoft)	Files.ReadWrite
Aplicativo	Sem suporte.

Solicitação HTTP

GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório.
Workbook-Session-Id	ID de sessão de pasta de trabalho que determina se as alterações são persistentes ou não. Opcional.

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro	Tipo	Descrição
height	number	Opcional. A altura desejada da imagem resultante.
width	number	Opcional. A largura desejada da imagem resultante.
fittingMode	cadeia de caracteres	Opcional. O método usado para dimensionar o gráfico para as dimensões especificadas (se height e width tiverem sido definidas). Os valores possíveis são: Fit, FitAndCenter e Fill.

Resposta

Se bem-sucedido, este método retorna o código de resposta 200 OK e a cadeia de caracteres de imagem em base64 no corpo da resposta.

Exemplo

Eis um exemplo de como chamar esta API.

Solicitação

Este é um exemplo da solicitação.

GET https://graph.microsoft.com/beta/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/Image(width=0,height=0,fittingMode='fit')

Resposta

Aqui está um exemplo da resposta. Observação: o objeto de resposta mostrado aqui pode ser reduzido para facilitar a leitura.

HTTP/1.1 200 OK
Content-type: application/json

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

Uso

Você pode exibir a cadeia de caracteres de Base 64 dentro de uma marca de imagem HTML: <img src="data:image/png;base64,{base-64 chart image string}/>.

Para o comportamento padrão, use Image(width=0,height=0,fittingMode='fit'). Veja um exemplo de uma imagem de gráfico retornada com os parâmetros padrão.

Se você quiser personalizar a exibição da imagem, especifique uma altura, largura e um modo de ajuste. Esta é a aparência da imagem de gráfico quando você a recupera com esses parâmetros: Image(width=500,height=500,fittingMode='Fill').