Resimleri Excel Çalışma Sayfasına İçe Aktar – Aspose.Cells Cloud API Kılavuzu
Bir Excel çalışma sayfasına resim eklemek, defterlerinizi logolar, grafikler veya diyagramlar gibi görsel içeriklerle zenginleştirmenizi sağlar. Bu kılavuz, Aspose.Cells Cloud ImportPicture işlemini, gerekli istek formatını ve yanıtları nasıl işleyeceğinizi gösterir.
Önkoşullar: İçe aktarma işlemini çağırmadan önce geçerli bir JWT kimlik doğrulama belirteci ve Aspose Cloud Depolama’da depolanmış mevcut bir çalışma kitabına sahip olmanız gerekir.
PostImportData API
POST https://api.aspose.cloud/v3.0/cells/import
Güvenlik ve Kimlik Doğrulama
Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.
İstek Parametreleri
İstek, HTTP POST türündedir ve multipart/related içeriğe sahiptir (bkz. RFC 2046 veya RFC 1341).
- İlk parça, resmin nereye ve nasıl yerleştirileceğini tanımlayan ImportPictureOption adlı bir JSON nesnesini içerir.
- İkinci parça, resim dosyasını (veya Base64 ile kodlanmış verilerini) taşır.
ImportPictureOption – tanım
{
"UpperLeftRow": 0,
"UpperLeftColumn": 0,
"LowerRightRow": 10,
"LowerRightColumn": 5,
"Filename": "logo.png",
"Data": "iVBORw0KGgoAAAANSUhEUgAA...",
"DestinationWorksheet": "Sheet1",
"IsInsert": true,
"ImportDataType": "Picture",
"Source": { "FileSource": "Storage" }
}
IsInsert, bir boolean değerdir – true yeni bir resim ekler, false mevcut birini değiştirir.
Önemli parametreler
ImportPictureOption
| Parametre Adı | Tür | Açıklama |
|---|---|---|
| UpperLeftRow | int | Resmin yerleştirileceği üst-sol köşesinin satır indeksi. |
| UpperLeftColumn | int | Resmin yerleştirileceği üst-sol köşesinin sütun indeksi. |
| LowerRightRow | int | Resmin sınırlarını belirleyen alt-sağ köşesinin satır indeksi. |
| LowerRightColumn | int | Resmin sınırlarını belirleyen alt-sağ köşesinin sütun indeksi. |
| Filename | string | Resim dosyasının adı. |
| Data | string | Resmin Base64 ile kodlanmış ikili verileri (dosya ikinci parça olarak gönderilmediyse isteğe bağlıdır). |
| DestinationWorksheet | string | Resmin ekleneceği çalışma sayfasının adı. |
| IsInsert | boolean | true yeni bir resim eklemek için; false mevcut birini değiştirmek için. |
| ImportDataType | string | İçe aktarılan veri türü (örn. Picture, IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData). |
| Source | FileSource | BatchData parametresi null olduğunda veri dosyasının konumunu belirtir. |
Yanıt
Başarılı bir istek, şu şekilde bir JSON içeriğiyle HTTP 200 döndürür:
{
"Code": 200,
"Status": "OK"
}
Olası durum kodları:
| Kod | Anlam |
|---|---|
| 200 | İçe aktarma başarılı |
| 400 | Geçersiz istek – eksik veya geçersiz veri |
| 401 | Yetkisiz erişim – geçersiz veya eksik belirteç |
| 500 | Sunucu iç hatası |
SDK’lar ile PostImportData API Nasıl Kullanılır?
PostImportData API Spesifikasyonu
OpenAPI Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenize olanak tanır.
Aspose.Cells Cloud SDK’larını Kullanma
SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoldur. Bir SDK, düşük seviye detayları işler, böylece projenizin görevlerine odaklanabilirsiniz. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposunu kontrol edin.
Aşağıdaki kod örnekleri, farklı SDK’lar kullanarak Aspose.Cells web hizmetlerini nasıl çağıracağınızı göstermektedir: