Excel Çalışma Sayfasında Bir Şekli Güncelleme - Aspose.Cells Cloud API

Bu REST API, bir Excel çalışma sayfasındaki bir şekli günceller.

Güvenlik ve Kimlik Doğrulama

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

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes/{shapeindex}

İstek Parametreleri

Parametre Adı Tür Konum Açıklama
name string path Çalışma kitabının dosya adı.
sheetName string path Şekli içeren çalışma sayfasının adı.
shapeindex integer path Çalışma sayfasındaki şeklin sıfır tabanlı dizini.
dto object body Güncellenmiş özellikleri içeren şekil veri aktarım nesnesi (aşağıda DTO Şeması’na bakın).
folder string query Çalışma kitabının bulunduğu klasör.
storageName string query Aspose Cloud depo adı.

DTO Şeması

dto nesnesi güncellenebilecek özellikleri içerir. Aksi belirtilmedikçe tüm alanlar isteğe bağlıdır.

Alan Tür Gerekli Açıklama
Name string Hayır Şeklin yeni adı.
UpperLeftRow integer Hayır Şeklin sol üst köşesinin satır dizini.
UpperLeftColumn integer Hayır Şeklin sol üst köşesinin sütun dizini.
Width integer Hayır Şeklin genişliği (nokta cinsinden).
Height integer Hayır Şeklin yüksekliği (nokta cinsinden).
RotationAngle integer Hayır Derece cinsinden dönüş açısı.
IsHidden boolean Hayır Şekli gizlemek için true.
IsLocked boolean Hayır Şekli kilitlemek için true.
Font object Hayır Yazı tipi ayarları (alt özellikler için OpenAPI spesifikasyonuna bakın).
… … Hayır HtmlText, AlternativeText, ZOrderPosition vb. gibi ek özellikler.

Tam liste için lütfen resmi OpenAPI spesifikasyonuna bakınız: https://apireference.aspose.cloud/cells/#/Shapes/PostWorksheetShape.

İstek Başlıkları

  • Content-Type: application/json
  • Accept: application/json
  • Authorization: Bearer <accessToken> (Kimlik Doğrulama adımından elde edilen JWT belirteci)

İstek Gövdesi (Örnek)

{
  "Name": "MyShape",
  "UpperLeftRow": 2,
  "UpperLeftColumn": 3,
  "Width": 150,
  "Height": 80,
  "RotationAngle": 0,
  "IsHidden": false,
  "IsLocked": false,
  "Font": {
    "Name": "Calibri",
    "Size": 12,
    "IsBold": true,
    "Color": { "A": 255, "R": 0, "G": 0, "B": 0 }
  }
}

cURL ile Örnek (Komut Satırı Aracı)

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes/0?folder=Temp" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
        "Name": "UpdatedShape",
        "UpperLeftRow": 1,
        "UpperLeftColumn": 1,
        "Width": 120,
        "Height": 60,
        "IsHidden": false,
        "IsLocked": false
      }'

Yanıt

{
  "Code": 200,
  "Status": "OK"
}

Hata Yönetimi – API aşağıdaki durum kodlarını döndürebilir:

Kod Anlamı Tipik neden
400 Geçersiz İstek Geçersiz JSON veya gerekli alanların eksikliği.
401 Yetkisiz İstek Eksik veya geçersiz JWT belirteci.
404 Bulunamadı Çalışma kitabı, çalışma sayfası veya şekil dizini yok.
500 Sunucu İç Hatası Beklenmeyen sunucu tarafı sorunu.

Hata Yanıt Örnekleri

400 – Geçersiz İstek

{
  "Code": 400,
  "Message": "Geçersiz istek yükü. 'Name' alanı maksimum uzunluğu aşıyor."
}

401 – Yetkisiz İstek

{
  "Code": 401,
  "Message": "Kimlik doğrulama başarısız. Geçersiz veya süresi dolmuş JWT belirteci."
}

404 – Bulunamadı

{
  "Code": 404,
  "Message": "Belirtilen çalışma kitabı, çalışma sayfası veya şekil dizini bulunamadı."
}

500 – Sunucu İç Hatası

{
  "Code": 500,
  "Message": "Sunucuda beklenmeyen bir hata oluştu."
}

Bulut SDK Ailesi

SDK kullanmak, geliştirme hızlandırmak için en iyi yoldur. Bir SDK, düşük seviye ayrıntıları yöneterek projenizdeki görevlere odaklanmanıza olanak tanır. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna bakın.

Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanarak Aspose.Cells web servislerini nasıl çağıracağınızı göstermektedir:

Excel Çalışma Sayfasına Bir Şekil Ekleyin Excel çalışma sayfasındaki tüm şekilleri sil