Bir Excel Çalışma Sayfasındaki Tüm Şekilleri Al

Bu REST API, bir Excel çalışma sayfasındaki tüm şekilleri alma işlemini sağlar.

Güvenlik ve Kimlik Doğrulama

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

REST API

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

İstek Parametreleri

Parametre Adı	Tür	Konum	Açıklama
name	string	path	Excel dosyasının adı.
sheetName	string	path	Çalışma sayfasının adı.
folder	string	query	Belgenin bulunduğu klasör.
storageName	string	query	Kullanılacak depolama hizmetinin adı.
include	string	query	`details` olarak ayarlandığında tam şekil özelliklerini döndürür; aksi takdirde yalnızca `link` nesneleri döner.

İsteğe Bağlı: Dosya kök depolama alanında yer alıyorsa folder, storageName ve include parametreleri atlanabilir.

cURL komut satırı aracını kullanarak Aspose.Cells web servislerine erişebilirsiniz. Aşağıdaki örnek, isteğe bağlı sorgu parametrelerini içeren bir istek göstermektedir.

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes?folder=Samples&storageName=MyStorage" \
-X GET \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Yanıt

{
  "Shapes": {
    "ShapeList": [
      {
        "link": {
          "Href": "/0",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/1",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/2",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      },
      {
        "link": {
          "Href": "/3",
          "Rel": "self",
          "Type": null,
          "Title": null
        }
      }
    ],
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes",
      "Rel": "self",
      "Type": null,
      "Title": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Yanıt Alanları

Shapes nesnesi, Shape ögelerinin bir listesini içerir. Her şekil, aşağıdaki özelliklere sahiptir (include=details bayrağı kullanıldığında); aksi takdirde yalnızca link nesnesi döner.

Özellik	Tür	Açıklama
Name	string	Şekile atanan ad (örn. “Chart 1”).
Type	string	Şekil türü (örn. `Chart`, `Picture`, `TextBox`).
Top	number	Çalışma sayfasının üst kenarından şeye kadar olan uzaklık (nokta cinsinden).
Left	number	Çalışma sayfasının sol kenarından şeye kadar olan uzaklık (nokta cinsinden).
Width	number	Şeklin genişliği (nokta cinsinden).
Height	number	Şeklin yüksekliği (nokta cinsinden).
Link	object	Hiperbağlantı bilgisi (`Href`, `Rel`, `Type`, `Title`).

Hata Yönetimi

HTTP Durumu	Açıklama	Örnek Hata Gövdesi
400	Geçersiz istek – hatalı parametreler.	`{ "Code": 400, "Message": "Geçersiz parametre değeri." }`
401	Yetkisiz erişim – eksik veya geçersiz belirteç.	`{ "Code": 401, "Message": "Erişim belirteci eksik veya geçersiz." }`
404	Bulunamadı – çalışma kitapçası veya çalışma sayfası yok.	`{ "Code": 404, "Message": "Dosya veya çalışma sayfası bulunamadı." }`
500	İç sunucu hatası – beklenmeyen durum.	`{ "Code": 500, "Message": "Beklenmeyen bir hata oluştu." }`

Başarılı bir istek, yukarıdaki yanıt örneğinde gösterildiği gibi, şekillerin listesini içeren bir Shapes nesnesi ile HTTP 200 durum kodu döner.

API, her JWT belirteci başına dakikada 150 istek sınırını uygular. Bu sınırı aşmak, yeniden deneme zamanını belirten bir Retry-After başlığı ile HTTP 429 döndürür.

Bulut SDK Grubu

SDK kullanmak, geliştirme hızını artırmak için en iyi yoldur. SDK, düşük seviye ayrıntıları yönetir ve size proje görevlerinize odaklanma imkanı verir. 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 servislerine istek yapmayı göstermektedir:

C#

Java

PHP

Ruby

Node.js

Python

Perl

Go

Excel Çalışma Sayfasında Dizine Göre Bir Şekil Alma