Aggiungi un'immagine a un foglio di lavoro Excel – Aspose.Cells Cloud API
Questa API REST aggiunge una nuova immagine a un foglio di lavoro Excel.
Prerequisiti: È necessario disporre di un token di autenticazione valido di Aspose Cloud, di un foglio di lavoro esistente archiviato in un’archiviazione supportata e delle opportune autorizzazioni per modificare il foglio di lavoro.
API PutWorksheetAddPicture
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures
Sicurezza e autenticazione
Le API di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.
Parametri della richiesta
| Nome parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
| name | string | path | Nome del foglio di lavoro. |
| sheetName | string | path | Nome del foglio di lavoro. |
| picture | object | body | Oggetto immagine (dati binari). |
| upperLeftRow | integer | query | Indice iniziale a zero della riga superiore sinistra in cui posizionare l’immagine. |
| upperLeftColumn | integer | query | Indice iniziale a zero della colonna superiore sinistra in cui posizionare l’immagine. |
| lowerRightRow | integer | query | Indice iniziale a zero della riga inferiore destra dell’area dell’immagine. |
| lowerRightColumn | integer | query | Indice iniziale a zero della colonna inferiore destra dell’area dell’immagine. |
| picturePath | string | query | Percorso del file immagine; se omesso, i dati dell’immagine devono essere forniti nel corpo della richiesta. |
| folder | string | query | Cartella contenente il foglio di lavoro. |
| storageName | string | query | Nome del servizio di archiviazione. |
Nota sul corpo della richiesta: Quando picturePath è omesso, inviare i dati binari dell’immagine nel corpo della richiesta utilizzando multipart/form-data.
Codici di stato HTTP
| Codice | Significato | Descrizione |
|---|---|---|
| 200 | OK | Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione. |
| 400 | Richiesta non valida | Parametri mancanti o non validi (ad es. tipo di file non supportato). |
| 401 | Non autorizzato | Token JWT non valido o mancante. |
| 413 | Payload troppo grande | Il file caricato supera il limite di dimensione. |
| 500 | Errore interno del server | Errore imprevisto sul server. |
Esempio di schema di risposta 200
{
"Code": 200,
"Status": "OK",
"PictureUrl": "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/1"
}
Nota: La dimensione massima dell’immagine è di 10 MB; i file più grandi verranno rifiutati con una risposta 400 Bad Request.
La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.
Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud con cURL.
Famiglia di SDK Cloud
L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:
Nota: I formati di immagine supportati includono PNG, JPEG, BMP e GIF. La dimensione massima dell’immagine è di 10 MB; i file più grandi verranno rifiutati con una risposta 400 Bad Request.