Aspose.Cells Cloud API – Hücre Aralığını Birleştir

Bu REST API, bir Excel çalışma sayfasındaki bir hücre aralığını tek bir hücrede birleştirir.

Genel Bakış – Bir aralığı birleştirmek, seçilen hücreleri tek bir hücrede birleştirir, üst‑sol hücrenin değerini korurken diğerlerini atar. Birden fazla sütunu veya satırı kapsayan bir başlık oluşturmak gerektiğinde veya bir çalışma sayfasının düzenini basitleştirmek istediğinizde bu işlemi kullanın.

REST API

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

İstek Parametreleri

Parametre Adı	Tür	Konum	Açıklama
name	string	path	Çalışma kitabının adı.
sheetName	string	path	Çalışma sayfasının adı.
range	object	body	Birleştirilecek hücreleri belirten aralık nesnesi.
folder	string	query	Çalışma kitabının bulunduğu klasör.
storageName	string	query	Depo adı.

İstek Gövdesi Şeması

Range nesnesi aşağıdaki alanları içermelidir (diğerleri isteğe bağlıdır):

Özellik	Tür	Zorunlu	Açıklama
FirstRow	integer	Evet	Aralıktaki ilk satırın sıfır tabanlı indeksi.
FirstColumn	integer	Evet	Aralıktaki ilk sütunun sıfır tabanlı indeksi.
RowCount	integer	Evet	Aralığa dahil edilecek satır sayısı.
ColumnCount	integer	Evet	Aralığa dahil edilecek sütun sayısı.
Name	string	Hayır	Aralığın isteğe bağlı adı.
RefersTo	string	Hayır	Aralığın işaret ettiği bir formül.
Worksheet	string	Hayır	Çalışma sayfası adı (yol parametresinden farklıysa).
RowHeight	number	Hayır	Aralıktaki satırların yüksekliği (piksel).
ColumnWidth	number	Hayır	Aralıktaki sütunların genişliği (piksel).

Aspose.Cells web servislerine kolayca erişmek için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile Bulut API’sine nasıl istek yapıldığını göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/merge" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "FirstRow": 9,
        "FirstColumn": 0,
        "RowCount": 1,
        "ColumnCount": 7
      }'

Yanıt

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

Yanıt Ayrıntıları

HTTP Durum Kodu	Açıklama	Örnek JSON
200 OK	Aralık başarıyla birleştirildi.	`{ "Code": 200, "Status": "OK" }`
400 Bad Request	Geçersiz aralık parametreleri (örn., sınırlar dışındaki indeksler).	`{ "Code": 400, "Message": "Invalid range." }`
401 Unauthorized	Eksik veya geçersiz JWT jetonu.	`{ "Code": 401, "Message": "Authentication failed." }`
404 Not Found	Çalışma kitabı veya çalışma sayfası bulunamadı.	`{ "Code": 404, "Message": "Resource not found." }`
500 Internal Server Error	Beklenmeyen sunucu hatası.	`{ "Code": 500, "Message": "Internal server error." }`

Bulut SDK Ailesi

Bir SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoldur. Bir SDK, düşük seviye ayrıntıları işler; böylece projenizin görevlerine odaklanabilirsiniz. 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 kullanılarak Aspose.Cells web servislerinin nasıl çağrılacağını göstermektedir: