Documentation –

Developer-Guide: Excel Çalışma Sayfasına Satır Ekleme

Mon, 01 Jan 0001 00:00:00 +0000

Excel Çalışma Sayfasına Satır Nasıl Eklenir?

Bu makale, Aspose.Cells Cloud REST API kullanarak mevcut bir çalışma sayfasına tek bir boş satır veya birden fazla satır ekleme yöntemini açıklar. İşleme geçmeden önce geçerli bir API anahtarına ve uygun SDK’nın kurulmuş olduğundan emin olun.

Ön Gereksinimler

Etkin aboneliğe sahip Aspose.Cells Cloud hesabı.
Aspose Cloud panosundan oluşturulmuş API anahtarı/Erişim belirteci.
Desteklenen SDK’lerden birinin (C#, Java, Python, Node.js) kurulmuş ve yapılandırılmış olması.

API Referansı

HTTP Yöntemi: POST
Uç Nokta: https://api.aspose.cloud/v3.0/cells/{dosyaAdı}/worksheets/{sayfaAdı}/rows
Gerekli Yol Parametreleri:
- fileName – Bulutta depolanan Excel dosyasının adı.
- sheetName – Satırların ekleneceği çalışma sayfasının adı.
Sorgu Parametreleri:
- startrow – Ekleme işleminin başlayacağı satırın sıfır tabanlı indeksi.
- totalRows – Eklenecek satır sayısı.
- folder – (İsteğe bağlı) Dosyanın bulunduğu bulut klasör yolu.
- storage – (İsteğe bağlı) Varsayılan olmayan bir depolama alanı kullanılıyorsa depolama adı.

İstek Gövdesi (JSON örneği):

{
  "startrow": 5,
  "totalRows": 3
}

cURL örneği

curl -X POST "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/rows?startrow=5&totalRows=3&folder=MyFolder&storage=MyStorage" \
    -H "Authorization: Bearer {access_token}" \
    -H "Content-Type: application/json" \
    -d '{"startrow":5,"totalRows":3}'

Başarılı Yanıt (HTTP 200): Güncellenmiş çalışma sayfası bilgilerini, yeni satır sayısını dahil ederek döndürür.

{
  "Code": 200,
  "Status": "OK",
  "Worksheet": {
    "Name": "Sheet1",
    "RowsCount": 30
  }
}

Hata Yanıt Örneği (HTTP 400):

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Geçersiz startrow parametresi. Pozitif bir tam sayı olmalıdır."
}

Durum Kodları:

Kod	Anlam
200	Satırlar başarıyla eklendi
400	Geçersiz parametreler veya bozuk JSON
401	Kimlik doğrulama başarısız
404	Dosya veya çalışma sayfası bulunamadı
500	Sunucu hatası

Aşağıda, satır eklemeyle ilgili ayrıntılı örneklerin hızlı bağlantıları yer almaktadır:

Developer-Guide: Bir Excel Çalışma Sayfasında Satırları Silme İşlemleri

Mon, 01 Jan 0001 00:00:00 +0000

Kullanılabilir Silme İşlemleri

Aşağıdaki örnekler, Aspose.Cells Cloud REST API kullanarak bir Excel çalışma sayfasından tek bir boş satırı veya birden fazla satırı nasıl sileceğinizi göstermektedir.

API Referansı

Öğe	Detaylar
HTTP Yöntemi	DELETE
Uç Nokta	`/cells/{fileName}/worksheets/{sheetName}/rows`
Yol Parametreleri	`fileName` – Excel dosyasının adı (zorunlu) `sheetName` – çalışma sayfasının adı (zorunlu)
Sorgu Parametreleri	`startrow` – silinecek ilk satırın indeksi (zorunlu) `totalRows` – silinecek satır sayısı (zorunlu) `storage` – bulut depo adı (isteğe bağlı) `folder` – depodaki klasör yolu (isteğe bağlı)
İstek Gövdesi	Yok
Yanıt Örneği	`json<br>{<br> "Code": 200,<br> "Status": "OK",<br> "RowsDeleted": 1<br>}<br>`
Olası Durum Kodları	200 OK – satırlar başarıyla silindi 400 Bad Request – geçersiz parametreler 401 Unauthorized – kimlik doğrulama hatası 404 Not Found – dosya veya çalışma sayfası bulunamadı 500 Internal Server Error – sunucu tarafında sorun

Ayrıca bakınız

Developer-Guide: Excel Çalışma Sayfasında Satırları Kopyalama

Mon, 01 Jan 0001 00:00:00 +0000

Excel Çalışma Sayfasında Satırları Kopyalama v3.0

Bir çalışma sayfasından belirli tüm satırlardan veri ve biçimleri kopyalayın.

Ön Gereksinimler

#	Gereksinim
1	Geçerli bir JWT belirteci. Kimlik doğrulama kılavuzuna bakınız.
2	Çalışma kitabının (`{name}`) seçilen klasör/depolar içinde zaten mevcut olması gerekir.
3	Hedef çalışma sayfasının (`{sheetName}`) çalışma kitabında mevcut olması gerekir.
4	(İsteğe bağlı) Dosya varsayılan konumda değilse klasör ve storageName bilgilerini bilmek.

Uç Nokta

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

Tüm yol parametreleri büyük/küçük harfe duyarlıdır.

Yol Parametreleri

Parametre	Tür	Gerekli	Açıklama
`name`	string	✅	Çalışma kitabının dosya adı (örn. `test.xlsx`).
`sheetName`	string	✅	Çalışma sayfasının adı (örn. `Sheet1`).

Sorgu Parametreleri

Parametre	Tür	Gerekli	Açıklama
`sourceRowIndex`	integer	✅	Kaynak satırın sıfır tabanlı indeksi.
`destinationRowIndex`	integer	✅	Satırların yerleştirileceği sıfır tabanlı indeks.
`rowNumber`	integer	✅	Kopyalanacak satır sayısı.
`worksheet`	string	❌	Çalışma sayfası tanımlayıcısı; genellikle sheetName ile aynıdır.
`folder`	string	❌	Çalışma kitabını içeren klasörün yolu.
`storageName`	string	❌	Depolama hizmetinin adı.

İstek Örneği (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/copy?sourceRowIndex=1&destinationRowIndex=12&rowNumber=10" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Not
<jwt token> ifadesini, kimlik doğrulama hizmetinden elde edilen geçerli bir JWT belirteci ile değiştirin.

Başarılı Yanıt

Kod	Açıklama
200	Satırlar başarıyla kopyalandı.

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

Yanıt gövdesi CellsCloudResponse türünden bir örnektir.

Hata İşleme

HTTP Kodu	Anlamı	Örnek Gövde
400	Geçersiz İstek – eksik/geçersiz parametreler.	`{ "Code": 400, "Message": "Invalid sourceRowIndex." }`
401	Yetkisiz – geçersiz veya eksik JWT belirteci.	`{ "Code": 401, "Message": "Authentication failed." }`
404	Bulunamadı – çalışma kitabı veya çalışma sayfası mevcut değil.	`{ "Code": 404, "Message": "File not found." }`
500	Sunucu İç Hatası – beklenmeyen sunucu koşulu.	`{ "Code": 500, "Message": "An unexpected error occurred." }`

İşleme yönergeleri

400 – Gerekli tüm sorgu parametrelerinin mevcut ve doğru biçimlendirildiğinden emin olun.
401 – JWT belirtecini yeniden oluşturun veya yenileyin.
404 – Çalışma kitabı ve çalışma sayfası adlarını doğrulayın ve dosyanın belirtilen klasör/depolamada mevcut olduğundan emin olun.
500 – Kısa bir gecikmeden sonra yeniden deneyin; sorun devam ederse Aspose desteğiyle iletişime geçin.

SDK Örnekleri

Aşağıdaki kod parçacıkları, resmi Aspose.Cells Cloud SDK’larıyla Satırları Kopyala işlemini nasıl çağıracağınızı göstermektedir.

Dil	Örnek
C#	Kodu göster `csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar api = new CellsApi("clientId", "clientSecret");\nawait api.PostCopyWorksheetRowsAsync(name: "test.xlsx", sheetName: "Sheet1", sourceRowIndex: 1, destinationRowIndex: 12, rowNumber: 10);\n`
Java	Kodu göster `java\nCellsApi api = new CellsApi("clientId", "clientSecret");\napi.postCopyWorksheetRows("test.xlsx", "Sheet1", 1, 12, 10, null, null, null);\n`
Python	Kodu göster `python\nfrom asposecellscloud import CellsApi\napi = CellsApi(client_id='clientId', client_secret='clientSecret')\napi.post_copy_worksheet_rows(name='test.xlsx', sheet_name='Sheet1', source_row_index=1, destination_row_index=12, row_number=10)\n`
Node.js	Kodu göster `javascript\nconst { CellsApi } = require('asposecellscloud');\nconst api = new CellsApi('clientId', 'clientSecret');\nawait api.postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Go	Kodu göster `go\nimport \"github.com/asposecellscloud/aspose-cells-cloud-go/v3\"\napi := cells.NewCellsApiClient(\"clientId\", \"clientSecret\")\n_, err := api.PostCopyWorksheetRows(context.Background(), \"test.xlsx\", \"Sheet1\", 1, 12, 10, nil, nil, nil)\n`
PHP	Kodu göster `php\nuse Aspose\Cells\CellsApi;\n$api = new CellsApi('clientId', 'clientSecret');\n$api->postCopyWorksheetRows('test.xlsx', 'Sheet1', 1, 12, 10);\n`
Ruby	Kodu göster `ruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::CellsApi.new('clientId', 'clientSecret')\napi.post_copy_worksheet_rows('test.xlsx', 'Sheet1', 1, 12, 10)\n`
Perl	Kodu göster `perl\nuse Aspose::Cells::CellsApi;\nmy $api = Aspose::Cells::CellsApi->new('clientId', 'clientSecret');\n$api->postCopyWorksheetRows(name => 'test.xlsx', sheetName => 'Sheet1', sourceRowIndex => 1, destinationRowIndex => 12, rowNumber => 10);\n`

Tüm kaynak dosyalar Aspose‑Cells‑Cloud GitHub deposunda mevcuttur.

Ayrıntılı Bilgi

Sayfa {{DATE}} tarihinde oluşturuldu. Bu API’nin en son sürümü için OpenAPI spesifikasyonuna bakınız.

Developer-Guide: Excel Çalışma Sayfasında Satırları Gizleme

Mon, 01 Jan 0001 00:00:00 +0000

Bu REST API, Excel çalışma sayfasında satırları gizler.

Önkoşullar: Aspose Cloud OAuth uç noktasından alınmış geçerli bir JWT Bearer belirteci, Aspose Cloud depolama alanına kaydedilmiş çalışma kitapçığı ve gizlenecek satırları içeren çalışma sayfasının adı. API, XLS, XLSX ve diğer desteklenen formatlardaki Excel dosyalarıyla çalışır.

PostHideWorksheetRows API

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

Güvenlik ve Kimlik Doğrulama

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

İstek Parametreleri

Parametre	Tür	Konum	Açıklama
name	string	path	Çalışma kitaplığı dosyasının adı.
sheetName	string	path	Gizlenecek satırları içeren çalışma sayfasının adı.
startrow	integer	query	Gizlenecek ilk satırın sıfır indeksli numarası.
totalRows	integer	query	startrow’dan itibaren ardışık olarak gizlenecek satır sayısı.
folder	string	query	Çalışma kitaplığının bulunduğu depodaki klasör.
storageName	string	query	Depolama hizmetinin adı.

OpenAPI Spesifikasyonu, bir web tarayıcısından doğrudan REST etkileşimlerinde bulunmanıza olanak tanıyan herkese açık bir programlama arayüzü sağlar.

cURL komut satırı aracını Aspose.Cells web servislerini çağırmak için kullanabilirsiniz. API, Aspose Cloud OAuth uç noktasından alınan bir JWT Bearer belirteci gerektirir; bunu Authorization başlığında eklemeniz gerekir. Aşağıdaki örnek, cURL ile bir satırı gizlemeyi göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/hide?startrow=1&totalRows=1" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Yanıt

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

Yanıt durum kodları

Kod	Açıklama
200	Başarılı – satırlar gizlendi
400	Geçersiz istek – hatalı parametreler
401	Yetkisiz – eksik veya geçersiz JWT
404	Bulunamadı – çalışma kitaplığı veya çalışma sayfası mevcut değil
500	Sunucu hatası – iç işlem başarısız

Başarılı bir çağrı, Code ve Status alanlarını içeren bir JSON nesnesi döndürür. Hata durumunda yanıt, Message ve uygun HTTP durum kodları (örneğin 400, 401, 404, 500) gibi ek alanlar içerir.

Notlar: startrow değerinin çalışma sayfasının satır aralığı içinde olduğundan emin olun; aksi takdirde API 400 hatası döndürür. Satır indeksleri sıfır tabanlıdır, yani startrow=0 birinci satıra karşılık gelir.

Bulut SDK Ailesi

Bu işlevselliği uygulamanıza entegre etmenin en hızlı yolu bir SDK kullanmaktır. SDK’lar düşük seviye detayları yöneterek size iş mantığına odaklanma imkanı verir. Aspose.Cells Cloud SDK’larının tam listesi için GitHub deposuna bakın.

Aşağıdaki kod örnekleri, farklı SDK’lar kullanılarak satırların nasıl gizleneceğini göstermektedir. (Örnek dosya adlarında “Unhide” ifadesinin geçmesinin neden eski isimlendirme kalıplarıdır; her gist içindeki kod aslında Gizle işlemini gerçekleştirmektedir.)

Developer-Guide: Excel Çalışma Sayfasında Satırları Tekrar Görünür Hale Getirme

Mon, 01 Jan 0001 00:00:00 +0000

Bu REST API, bir Excel çalışma sayfasındaki satırları tekrar görünür hale getirir.

Ön Koşullar: Bu uç noktayı çağırmadan önce Aspose Cloud kimlik doğrulama hizmetinden geçerli bir JWT erişim belirteci almanız ve hedef çalışma kitabının desteklenen bir depoya yüklenmiş olması gerekir.

PostUnhideWorksheetRows API

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

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	Çalışma kitabının adı.
sheetName	string	path	Çalışma sayfasının adı.
startrow	integer	query	Tekrar görünür hale getirilecek ilk satırın sıfır tabanlı dizini.
totalRows	integer	query	Tekrar görünür hale getirilecek satır sayısı.
height	number	query	Satır yüksekliği (varsayılan 15.0).
folder	string	query	Belge klasörü.
storageName	string	query	Depo adı.

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ştirmenizi sağlar.

Kimlik Doğrulama
Tüm istekler, Aspose Cloud kimlik doğrulama hizmetinden alınan JWT erişim belirteci kullanılarak doğrulanmalıdır. Belirteci Authorization: Bearer <jwt token> başlığına ekleyin.

Aspose.Cells web hizmetlerine kolayca ulaşmak 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/cells/rows/unhide?startrow=1&totalRows=1&height=15" \
 -X POST \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer <jwt token>"
# Not: Bu uç nokta için POST gövdesi boştur

Yanıt

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

HTTP Durum Kodları

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

Ayrıntılı sorun giderme için Hata Yönetimi kılavuzuna bakın.

Bulut SDK Geliştirme Takımı

SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoludur. SDK, düşük seviye ayrıntıları yöneterek size proje görevlerine odaklanma imkânı sunar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub Deposu‘na bakın.

Aşağıdaki kod örnekleri, Aspose.Cells web hizmetlerine farklı SDK’lar kullanılarak nasıl istek yapıldığını göstermektedir:

Developer-Guide: Excel Çalışma Sayfasında Satırları Gruplama

Mon, 01 Jan 0001 00:00:00 +0000

Bu REST API, bir Excel çalışma sayfasında satırları gruplar.

Önkoşullar:

Geçerli bir OAuth 2.0 erişim belirteci (Bearer JWT), Authorization başlığına eklenmelidir.
İstek gönderilmeden önce çalışma kitabının, seçilen storageName (veya varsayılan depo) içinde belirtilen folder klasöründe zaten bulunuyor olması gerekir.

PostGroupWorksheetRows API

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

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	Çalışma kitabının dosya adı.
sheetName	string	path	Çalışma sayfasının adı.
firstIndex	integer	query	Gruplandırılacak ilk satırın sıfır tabanlı indeksi.
lastIndex	integer	query	Gruplandırılacak son satırın sıfır tabanlı indeksi.
hide	boolean	query	Gruplanan satırların gizlenip gizlenmeyeceğini belirtir (`true` veya `false`).
folder	string	query	Çalışma kitabını içeren klasörün yolu.
storageName	string	query	Çalışma kitabının bulunduğu depo adı.

OpenAPI Specification, genel olarak erişilebilir 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 web servislerine kolayca erişmek için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile Cloud API’ye nasıl istek atılacağını göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/group?firstIndex=1&lastIndex=2&hide=true" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Yanıt

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

HTTP Durum Kodları

Kod	Anlamı	Açıklama
200	OK (Tamam)	Filtre başarıyla uygulandı; yanıt işlem ayrıntılarını içerir.
400	Bad Request (Hatalı İstek)	Eksik veya geçersiz parametreler (örn., desteklenmeyen dosya türü).
401	Unauthorized (Yetkisiz)	Geçersiz veya eksik JWT belirteci.
413	Payload Too Large (Çok Büyük Yük)	Yüklenecek dosya boyut sınırını aşıyor.
500	Internal Server Error (İç Sunucu Hatası)	Beklenmeyen sunucu hatası.

Yaygın hata yanıtları:

400 Bad Request (Hatalı İstek) – firstIndex ve lastIndex değerlerinin geçerli tam sayılar olduğunu ve firstIndex ≤ lastIndex koşulunu sağladığını kontrol edin.
401 Unauthorized (Yetkisiz) – Authorization başlığının güncel bir JWT belirteci içerdiğini doğrulayın.
404 Not Found (Bulunamadı) – Çalışma kitabının (name) ve çalışma sayfasının (sheetName) belirtilen folder/storageName içinde mevcut olduğundan emin olun.

Ayrıca bakınız: Excel çalışma sayfasında satırların gruplamasını kaldırma, Excel çalışma sayfasında satırları gizleme, Excel çalışma sayfasında satırların gizliliğini kaldırma.

Bulut SDK Geliştirme Paketi

Bir SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoldur. Bir SDK, düşük seviyeli ayrıntıları yöneterek size proje görevlerinize odaklanmanızı sağlar. 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:

Developer-Guide: Excel Çalışma Sayfasında Satırların Gruplamasını Kaldırma

Mon, 01 Jan 0001 00:00:00 +0000

Bu REST API, Excel çalışma sayfasındaki satırların gruplamasını kaldırır.

REST API

POST http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/rows/ungroup

İ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ı.
firstIndex	integer	query	Gruplaması kaldırılacak ilk satırın sıfır tabanlı indeksi.
lastIndex	integer	query	Gruplaması kaldırılacak son satırın sıfır tabanlı indeksi.
isAll	boolean	query	true ise, belirtilen aralıktaki tüm satırların gruplaması kaldırılır.
folder	string	query	Çalışma kitabının bulunduğu klasör.
storageName	string	query	Çalışma kitabının bulunduğu depo adı.

OpenAPI Specification, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenizi 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 nasıl istek gönderileceğini göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/rows/ungroup?firstIndex=1&lastIndex=5&isAll=true" \
 -X POST \
 -H "Content-Type: application/json" \
 -H "Accept: application/json" \
 -H "Authorization: Bearer <jwt token>"

Yanıt

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

Bulut SDK Topluluğu

SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoludur. Bir SDK, düşük seviye detayları yönetir ve projenizdeki görevlere odaklanmanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna göz atın.

Aşağıdaki kod örnekleri, çeşitli SDK’ları kullanarak Aspose.Cells web hizmetlerine nasıl istek gönderileceğini göstermektedir:

Developer-Guide: Aspose.Cells Cloud API ile bir Excel Çalışma Sayfasından Tek Bir Satır Alın

Thu, 30 Jul 2026 00:00:00 +0000

Bir Excel Çalışma Sayfasından Tek Bir Satır Alın

Uç Nokta: GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/rows/{rowIndex}

Aspose Cloud Deposu’nda depolanan bir çalışma sayfasından bir satır alın. Bu işlem Read (Okuma) kapsamlı geçerli bir OAuth 2.0 erişim belirteci gerektirir.

İçindekiler

Ön Gereksinimler

Aktif aboneliğe sahip Aspose Cloud hesabı.
Read (Okuma) kapsamlı OAuth 2.0 erişim belirteci.
Hedef çalışma kitabının zaten Aspose Cloud Deposu’nda bulunuyor olması gerekir.

HTTP İsteği

GET /cells/{name}/worksheets/{sheetName}/rows/{rowIndex}?folder={folder}&storageName={storageName} HTTP/1.1
Host: api.aspose.cloud
Authorization: Bearer {access_token}
Accept: application/json

Temel URL: https://api.aspose.cloud/v3.0

Parametreler

Yol parametreleri

Ad	Tür	Gerekli	Açıklama
`name`	string	✅	Çalışma kitabı dosyasının adı (örneğin, `MyWorkbook.xlsx`).
`sheetName`	string	✅	Çalışma sayfasının adı (örneğin, `Sheet1`).
`rowIndex`	integer	✅	Alınacak satırın sıfır tabanlı indeksi.

Sorgu parametreleri (isteğe bağlı)

Ad	Tür	Gerekli	Açıklama
`folder`	string	❌	Çalışma kitabının bulunduğu bulut deposundaki klasör yolu.
`storageName`	string	❌	Kullanılan depolama hizmetinin adı (özel bir depo kullanıyorsanız).

cURL Örneği

curl -X GET "https://api.aspose.cloud/v3.0/cells/MyWorkbook.xlsx/worksheets/Sheet1/rows/5?folder=Docs&storageName=MyStorage" \
     -H "Authorization: Bearer {access_token}" \
     -H "Accept: application/json"

Yanıt

Başarılı şema (`200 OK`)

{
  "Code": 200,
  "Status": "OK",
  "Row": {
    "Index": 5,
    "Height": 15.0,
    "Style": { /* style nesnesi */ },
    "Cells": [
      { "ColumnIndex": 0, "Value": "A6", "DataType": "String" },
      { "ColumnIndex": 1, "Value": 123, "DataType": "Number" }
      /* ...ek hücreler... */
    ]
  }
}

Durum kodları

Kod	Anlam
200	Satır başarıyla alındı.
401	Yetkisiz – eksik veya geçersiz erişim belirteci.
404	Çalışma kitabı, çalışma sayfası veya satır bulunamadı.
500	Sunucu iç hatası.

Hata örneği (`401 Unauthorized`)

{
  "Code": 401,
  "Message": "Erişim belirteci eksik veya geçersiz."
}

SDK Kod Örnekleri

C#

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var clientId = "YOUR_CLIENT_ID";
var clientSecret = "YOUR_CLIENT_SECRET";

var api = new CellsApi(clientId, clientSecret);
var response = api.CellsRows_GetWorksheetRow(
    name: "MyWorkbook.xlsx",
    sheetName: "Sheet1",
    rowIndex: 5,
    folder: "Docs",
    storageName: null   // isteğe bağlı
);

Console.WriteLine($"Satır {response.Row.Index}, {response.Row.Cells.Count} hücre ile alındı.");

Java

import com.aspose.cloud.cells.api.CellsApi;
import com.aspose.cloud.cells.model.RowResponse;

CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
RowResponse response = api.cellsRowsGetWorksheetRow(
    "MyWorkbook.xlsx",
    "Sheet1",
    5,
    "Docs",
    null   // storageName – isteğe bağlı
);

System.out.println("Satır indeksi: " + response.getRow().getIndex());
System.out.println("Hücre sayısı: " + response.getRow().getCells().size());

Python

from asposecellscloud import CellsApi, ApiException
from asposecellscloud.models import RowResponse

client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

api = CellsApi(client_id, client_secret)

try:
    response = api.cells_rows_get_worksheet_row(
        name="MyWorkbook.xlsx",
        sheet_name="Sheet1",
        row_index=5,
        folder="Docs",
        storage_name=None
    )
    print(f"Satır {response.row.index}, {len(response.row.cells)} hücre ile alındı.")
except ApiException as e:
    print("CellsApi->cells_rows_get_worksheet_row çağrısı sırasında istisna:", e)

İlgili İşlemler

İşlem	Açıklama
Satır Ekle	`POST /cells/{name}/worksheets/{sheetName}/rows` – Çalışma sayfasına yeni bir satır ekler.
Satır Sil	`DELETE /cells/{name}/worksheets/{sheetName}/rows/{rowIndex}` – Mevcut bir satırı kaldırır.
Birden Fazla Satır Al	`GET /cells/{name}/worksheets/{sheetName}/rows` – Birden fazla satırın koleksiyonunu alır.
Satırlara Genel Bakış	`/cells/rows/` – Satır ile ilgili uç noktalar için genel belgeler.

Notlar ve Sınırlamalar

Oran sınırı: Hesap başına dakikada 100 istek.
Desteklenen formatlar: XLS, XLSX, CSV, ODS.
Satır indeksi sıfır tabanlıdır; ilk satır 0‘dır.
Bu uç noktayı çağırmadan önce çalıştırma kitabının belirtilen folder klasörüne yüklenmiş olduğundan emin olun.

Documentation –

Developer-Guide: Excel Çalışma Sayfasına Satır Ekleme

Excel Çalışma Sayfasına Satır Nasıl Eklenir?

Developer-Guide: Bir Excel Çalışma Sayfasında Satırları Silme İşlemleri

Kullanılabilir Silme İşlemleri

Developer-Guide: Excel Çalışma Sayfasında Satırları Kopyalama

Excel Çalışma Sayfasında Satırları Kopyalama v3.0

Ön Gereksinimler

Uç Nokta

Yol Parametreleri

Sorgu Parametreleri

İstek Örneği (cURL)

Başarılı Yanıt

Hata İşleme

SDK Örnekleri

Ayrıntılı Bilgi

Developer-Guide: Excel Çalışma Sayfasında Satırları Gizleme

PostHideWorksheetRows API

Güvenlik ve Kimlik Doğrulama

İstek Parametreleri

Bulut SDK Ailesi

Developer-Guide: Excel Çalışma Sayfasında Satırları Tekrar Görünür Hale Getirme

PostUnhideWorksheetRows API

Güvenlik ve Kimlik Doğrulama

İstek Parametreleri

Bulut SDK Geliştirme Takımı

Developer-Guide: Excel Çalışma Sayfasında Satırları Gruplama

PostGroupWorksheetRows API

Güvenlik ve Kimlik Doğrulama

İstek Parametreleri

Bulut SDK Geliştirme Paketi

Developer-Guide: Excel Çalışma Sayfasında Satırların Gruplamasını Kaldırma

REST API

İstek Parametreleri

Bulut SDK Topluluğu

Developer-Guide: Aspose.Cells Cloud API ile bir Excel Çalışma Sayfasından Tek Bir Satır Alın

Bir Excel Çalışma Sayfasından Tek Bir Satır Alın

İçindekiler

Ön Gereksinimler

HTTP İsteği

Parametreler

Yol parametreleri

Sorgu parametreleri (isteğe bağlı)

cURL Örneği

Yanıt

Başarılı şema (200 OK)

Durum kodları

Hata örneği (401 Unauthorized)

SDK Kod Örnekleri

C#

Java

Python

İlgili İşlemler

Notlar ve Sınırlamalar

Başarılı şema (`200 OK`)

Hata örneği (`401 Unauthorized`)