Excel Çalışma Sayfasına Resim Ekleyin – Aspose.Cells Cloud API

Bu REST API, bir Excel çalışma sayfasına yeni bir resim ekler.
Önkoşullar: Geçerli bir Aspose Cloud kimlik doğrulama belirteci, desteklenen bir depolama ortamında bulunan mevcut bir hesap kitabınız ve çalışma sayfasını değiştirme yetkiniz olmalıdır.

PutWorksheetAddPicture API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures

Güvenlik ve Kimlik Doğrulama

Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.

İstek Parametreleri

Parametre Adı Tür Konum Açıklama
name string path Hesap kitabı adı.
sheetName string path Çalışma sayfası adı.
picture object body Resim nesnesi (ikili veri).
upperLeftRow integer query Resmin yerleştirileceği sol üst köşe satırının sıfır tabanlı indeksi.
upperLeftColumn integer query Resmin yerleştirileceği sol üst köşe sütununun sıfır tabanlı indeksi.
lowerRightRow integer query Resim alanının sağ alt köşe satırının sıfır tabanlı indeksi.
lowerRightColumn integer query Resim alanının sağ alt köşe sütununun sıfır tabanlı indeksi.
picturePath string query Resim dosyasının yolu; atlanırsa, resim verisi istek gövdesinde sağlanmalıdır.
folder string query Hesap kitabının bulunduğu klasör.
storageName string query Depolama hizmetinin adı.

İstek Gövdesi Notu: picturePath atlandığında, ikili resim verisini multipart/form-data kullanarak istek gövdesinde gönderin.

HTTP Durum Kodları

Kod Anlam Açıklama
200 Tamam Filtre başarıyla uygulandı; yanıt işlem detaylarını içerir.
400 Hatalı İstek Eksik veya geçersiz parametreler (örn., desteklenmeyen dosya türü).
401 Yetkisiz Geçersiz veya eksik JWT belirteci.
413 Yük Çok Büyük Yüklenen dosya boyut sınırlarını aşıyor.
500 Sunucu İç Hatası Beklenmeyen sunucu hatası.

Örnek 200 Yanıt Şeması

{
  "Code": 200,
  "Status": "OK",
  "PictureUrl": "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/1"
}

Not: Maksimum resim boyutu 10 MB’dır; daha büyük dosyalar 400 Bad Request (Hatalı İstek) yanıtıyla reddedilir.

OpenAPI Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından yapmanızı sağlar.

Aspose.Cells web hizmetlerine kolayca erişmek için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile Cloud API’ye istek yapmayı göstermektedir.

Bulut SDK’sı Ailesi

SDK kullanmak, geliştirme hızını en çok artıracak en iyi yoldur. SDK, düşük seviye ayrıntıları yöneterek size proje görevlerinize odaklanma imkanı sunar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna göz atın.

Aşağıdaki kod örnekleri, farklı SDK’lar kullanarak Aspose.Cells web hizmetlerine istek yapmayı göstermektedir:

Not: Desteklenen resim formatları şunlardır: PNG, JPEG, BMP ve GIF. Maksimum resim boyutu 10 MB’dır; daha büyük dosyalar 400 Bad Request (Hatalı İstek) yanıtıyla reddedilir.