Ein Bild zu einem Excel-Arbeitsblatt hinzufügen – Aspose.Cells Cloud API
Diese REST API fügt ein neues Bild zu einem Excel-Arbeitsblatt hinzu.
Voraussetzungen: Sie benötigen einen gültigen Aspose Cloud-Authentifizierungstoken, eine bestehende Arbeitsmappe, die in einem unterstützten Speicher gespeichert ist, sowie entsprechende Berechtigungen zum Bearbeiten des Arbeitsblatts.
PutWorksheetAddPicture API
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Anforderungsparameter
| Parametername | Typ | Ort | Beschreibung |
|---|---|---|---|
| name | string | path | Der Name der Arbeitsmappe. |
| sheetName | string | path | Der Name des Arbeitsblatts. |
| picture | object | body | Bildobjekt (binäre Daten). |
| upperLeftRow | integer | query | Nullbasierter Index der oberen linken Zeile, an der das Bild platziert wird. |
| upperLeftColumn | integer | query | Nullbasierter Index der oberen linken Spalte, an der das Bild platziert wird. |
| lowerRightRow | integer | query | Nullbasierter Index der unteren rechten Zeile des Bildbereichs. |
| lowerRightColumn | integer | query | Nullbasierter Index der unteren rechten Spalte des Bildbereichs. |
| picturePath | string | query | Pfad zur Bilddatei; falls weggelassen, müssen die Bilddaten im Anforderungstext übergeben werden. |
| folder | string | query | Der Ordner, der die Arbeitsmappe enthält. |
| storageName | string | query | Der Name des Speicherdienstes. |
Hinweis zum Anforderungstext: Wenn picturePath weggelassen wird, senden Sie die binären Bilddaten im Anforderungstext im Format multipart/form-data.
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; Antwort enthält Details zur Operation. |
| 400 | Ungültige Anforderung | Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp). |
| 401 | Nicht autorisiert | Ungültiger oder fehlender JWT-Token. |
| 413 | Anforderungstext zu groß | Die hochgeladene Datei überschreitet das Größenlimit. |
| 500 | Interner Serverfehler | Unerwarteter Serverfehler. |
Beispiel für 200-Antwortschema
{
"Code": 200,
"Status": "OK",
"PictureUrl": "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/1"
}
Hinweis: Die maximale Bildgröße beträgt 10 MB; größere Dateien werden mit einer 400 Bad Request-Antwort abgelehnt.
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser heraus durchzuführen.
Sie können das cURL-Befehlszeilentool nutzen, um problemlos auf Aspose.Cells-Webdienste zuzugreifen. Im folgenden Beispiel wird gezeigt, wie Sie mit cURL Aufrufe an die Cloud-API durchführen.
Cloud SDK-Familie
Die Verwendung eines SDKs ist die beste Möglichkeit, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Details auf niedriger Ebene, sodass Sie sich auf die Aufgaben Ihres Projekts konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webdienste mit verschiedenen SDKs durchgeführt werden:
Hinweis: Unterstützte Bildformate sind PNG, JPEG, BMP und GIF. Die maximale Bildgröße beträgt 10 MB; größere Dateien werden mit einer 400 Bad Request-Antwort abgelehnt.