Add Background Image to Workbook
This REST API adds a background image to an Excel workbook.
REST API
| API | Type | Description | Resource Link |
|---|---|---|---|
/cells/{name}/background |
PUT | Add a background image to an Excel file | PutWorkbookBackground |
Query Parameters
| Parameter Name | Type | Description |
|---|---|---|
picPath |
string | Path to the picture file to be used as background. |
folder |
string | Folder that contains the original workbook. |
storageName |
string | Name of the storage where the file resides. |
Request Body Parameter
| Parameter Name | Type | Description |
|---|---|---|
datafile |
file | The workbook file to which the background will be applied. |
Path Parameter – {name} in the URL represents the workbook file name (e.g., Book1.xlsx).
The OpenAPI Specification defines a publicly accessible programming interface that lets you perform REST interactions directly from a web browser.
You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows a complete request, including the multipart file upload flag and the required authentication header.
Error Responses
| HTTP Status | Code | Message | When it occurs |
|---|---|---|---|
| 400 | Bad Request | The request is malformed or missing required parameters. | |
| 401 | Unauthorized | Invalid or missing OAuth 2.0 token. | |
| 404 | Not Found | The specified workbook ({name}) or picture file does not exist. |
|
| 500 | Internal Server Error | An unexpected error occurred on the server side. |
Cloud SDK Family
Using an SDK is the fastest way to develop. An SDK abstracts low‑level details so you can concentrate on your business logic. See the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.
The following code examples demonstrate how to call Aspose.Cells web services using various SDKs: