Chart: Image
Espacio de nombres: microsoft.graph
Representa el gráfico como una imagen con codificación Base64 al escalar el gráfico a las dimensiones especificadas.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
---|---|---|
Delegado (cuenta profesional o educativa) | Files.ReadWrite | No disponible. |
Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
Aplicación | No admitida. | No admitida. |
Solicitud HTTP
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640)
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image(width=640)
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480)
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480)
GET /me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
GET /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
Encabezados de solicitud
Nombre | Descripción |
---|---|
Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Workbook-Session-Id | Identificador de sesión de libro que determina si los cambios se conservan o no. Opcional. |
Parámetros de ruta de acceso
En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.
Parámetro | Tipo | Descripción |
---|---|---|
height | Int32 | Alto deseado de la imagen resultante. Opcional. |
width | Int32 | Ancho deseado de la imagen resultante. Opcional. |
fittingMode | string | El método utilizado para escalar el gráfico a las dimensiones especificadas (si se establecen tanto el alto como el ancho)." Los valores posibles son: Fit , FitAndCenter , Fill . |
Respuesta
Si se ejecuta correctamente, este método devuelve el código de respuesta 200 OK
y la cadena de imagen en base 64 en el cuerpo de la respuesta.
Ejemplo
Aquí tiene un ejemplo de cómo llamar a esta API.
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{id|name}/charts/{name}/image(width=640,height=480,fittingMode='fit')
Respuesta
En el ejemplo siguiente se muestra la respuesta. Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-type: application/json;odata.metadata=minimal;odata.streaming=true
{
"value" : "base-64 chart image string"
}
Uso
Puede mostrar la cadena en base 64 en una etiqueta de imagen HTML: <img src="data:image/png;base64,{base-64 chart image string}/>
.
Para usar el comportamiento predeterminado, utilice Image(width=0,height=0,fittingMode='fit')
. Este es un ejemplo de una imagen de gráfico devuelta con los parámetros predeterminados.
Si quiere personalizar la visualización de la imagen, especifique un alto, un ancho y un modo de ajuste. Esta es la apariencia de la misma imagen de gráfico si la recupera con estos parámetros: Image(width=500,height=500,fittingMode='Fill')
.
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de