Belirli Bir Belge Özelliğini Alın

Bu REST API, belirli bir adla belge özelliğini okur.

REST API

GET https://api.aspose.cloud/v3.0/cells/{name}/documentproperties/{propertyName}

İstek Parametreleri

Parametre Adı	Tür	Konum	Açıklama
name	string	path	Excel dosyasının adı.
propertyName	string	path	Alınacak belge özelliğinin adı.
folder	string	query	Dosyayı içeren klasör (isteğe bağlı).
storageName	string	query	Depo adı (isteğe bağlı).

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ştirmenize olanak tanır.

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

İstek

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/documentproperties/author" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Yanıt

{
  "DocumentProperty": {
    "Name": "Yazar",
    "Value": "",
    "BuiltIn": "True",
    "link": {
      "Href": "/test.xlsx/documentproperties/Author",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

Yanıt Ayrıntıları

API tarafından döndürülen JSON nesnesi aşağıdaki alanları içerir:

Alan	Tür	Açıklama
DocumentProperty.Name	string	Özelliğin adı (örneğin `Author`).
DocumentProperty.Value	string	Özelliğin değeri. Ayarlanmamışsa boş olabilir.
DocumentProperty.BuiltIn	boolean	Özelliğin yerleşik Excel özelliği olup olmadığını gösterir.
DocumentProperty.link.Href	string	Özellik kaynağına olan göreli URL.
DocumentProperty.link.Rel	string	İlişki türü; genellikle `self`.
DocumentProperty.link.Title	string	İnsan tarafından okunabilir başlık (`null` olabilir).
DocumentProperty.link.Type	string	Bağlantılı kaynağın MIME türü (`null` olabilir).
Code	integer	Hizmet tarafından döndürülen HTTP durum kodu.
Status	string	Durumun metinsel açıklaması (örneğin `OK`).

Hata Yanıtları

HTTP Durumu	Kod	Açıklama
400	`InvalidParameter`	Bir veya daha fazla istek parametresi geçersiz.
401	`AuthenticationFailed`	Eksik veya geçersiz JWT jetonu.
404	`PropertyNotFound`	Belirtilen belge özelliği mevcut değil.
500	`InternalError`	Sunucuda beklenmeyen bir hata oluştu.

Tipik bir hata gövdesi şu şekildedir:

{
  "Code": 404,
  "Status": "Özellik bulunamadı"
}

Bulut SDK Ailesi

SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoldur. SDK, düşük seviye detayları kendisi yönetir, böylece projenizin görevlerine odaklanabilirsiniz. Aspose.Cells Bulut SDK’larının tam listesi için lütfen GitHub deposuna bakın.

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

Terimler

Terim	Tanım
Belge Özelliği	Bir Excel defteriyle ilişkili meta veri parçası (örneğin Yazar, Başlık, Oluşturulma Tarihi).
Meta Veri	Diğer verileri açıklayan veri için genel terim; bu bağlamda belge özellikleri kastedilir.
Özel Özellik	Yerleşik özellik setinde bulunmayan kullanıcı tanımlı bir özellik.

Sık Sorulan Sorular

S: Aspose Cloud’da depolanan bir Excel dosyasının Yazar özelliğini nasıl alabilirim?
C: Geçerli bir Bearer jetonu ile https://api.aspose.cloud/v3.0/cells/{dosyaAdı}/documentproperties/author adresine bir GET isteği gönderin. Yanıt JSON’unda DocumentProperty.Name = "Yazar" ve Value alanı bulunur.

S: İstenen özellik mevcut değilse hangi hata döndürülür?
C: API, HTTP 404 durumu ile birlikte Code: 404 ve Status: "Özellik bulunamadı" içeren bir JSON gövdesi döndürür.

S: Dosya varsayılan depoda bulunuyorsa storageName belirtmem gerekiyor mu?
C: Hayır. storageName sorgu parametresi isteğe bağlıdır; hesabınız için yapılandırılmış varsayılan depoyu kullanmak için bu parametreyi atlayın.

Excel dosyalarından meta veri alın