الحصول على خاصية مستند محددة
تقوم هذه الواجهة البرمجية للتطبيقات (REST API) بقراءة خاصية المستند حسب اسمها.
واجهة برمجة التطبيقات (REST API)
GET https://api.aspose.cloud/v3.0/cells/{name}/documentproperties/{propertyName}
مُعلَمات الطلب
| اسم المُعلَمة | النوع | الموقع | الوصف |
|---|---|---|---|
| name | string | path | اسم ملف إكسل. |
| propertyName | string | path | اسم خاصية المستند المراد استرجاعها. |
| folder | string | query | المجلد الذي يحتوي على الملف (اختياري). |
| storageName | string | query | اسم وحدة التخزين (اختياري). |
يُعرّف مواصفة OpenAPI واجهة برمجة تطبيقات متاحة عمومًا، وتتيح لك تنفيذ تفاعلات REST مباشرة من متصفح الويب.
يمكنك استخدام أداة cURL لسهولة الوصول إلى خدمات Aspose.Cells عبر الويب. يُظهر المثال التالي كيفية إجراء المكالمات إلى واجهة برمجة التطبيقات السحابية باستخدام cURL.
تفاصيل الاستجابة
يحتوي كائن JSON المُعاد من الواجهة البرمجية على الحقول التالية:
| الحقل | النوع | الوصف |
|---|---|---|
| DocumentProperty.Name | string | اسم الخاصية (مثل Author). |
| DocumentProperty.Value | string | قيمة الخاصية. قد تكون فارغة إذا لم تُحدّد. |
| DocumentProperty.BuiltIn | boolean | يُشير إلى ما إذا كانت الخاصية جزءًا من مجموعة خصائص إكسل المدمجة. |
| DocumentProperty.link.Href | string | عنوان URL النسبي لمورد الخاصية. |
| DocumentProperty.link.Rel | string | نوع العلاقة، وغالبًا ما يكون self. |
| DocumentProperty.link.Title | string | عنوان قابل للقراءة (قد يكون null). |
| DocumentProperty.link.Type | string | نوع MIME لمورد الارتباط (قد يكون null). |
| Code | integer | رمز حالة HTTP الذي تعيده الخدمة. |
| Status | string | وصف نصّي لحالة الطلب (مثل OK). |
استجابات الأخطاء
| حالة HTTP | الرمز | الوصف |
|---|---|---|
| 400 | InvalidParameter |
أحد مُعلَمات الطلب أو أكثر غير صالحة. |
| 401 | AuthenticationFailed |
رمز JWT مفقود أو غير صالح. |
| 404 | PropertyNotFound |
خاصية المستند المحددة غير موجودة. |
| 500 | InternalError |
حدث خطأ غير متوقع على الخادم. |
يبدو محتوى الخطأ النموذجي كالتالي:
{
"Code": 404,
"Status": "Property not found"
}
عائلة SDK للسحابة
استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. فالـ SDK يتعامل مع التفاصيل منخفضة المستوى، مما يمكّنك من التركيز على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.
تُظهر أمثلة الكود التالية كيفية إجراء المكالمات إلى خدمات Aspose.Cells باستخدام SDKs مختلفة:
المصطلحات
| المصطلح | التعريف |
|---|---|
| خصائص المستند | جزء من بيانات التعريف المرتبطة بمصنف إكسل (مثل المؤلف أو العنوان أو تاريخ الإنشاء). |
| بيانات التعريف | مصطلح عام يشير إلى البيانات التي تصف بيانات أخرى؛ وفي هذا السياق يشير إلى خصائص المستند. |
| خصائص مخصّصة | خصائص يحددها المستخدم ولا تندرج ضمن الخصائص المدمجة. |
الأسئلة الشائعة
س: كيف يمكنني استرجاع خاصية المؤلف لملف إكسل مخزن في Aspose Cloud؟
ج: أرسل طلب GET إلى https://api.aspose.cloud/v3.0/cells/{fileName}/documentproperties/author مع رمز Bearer صالح. ستتضمن استجابة JSON الحقل DocumentProperty.Name = "Author" وقيمته Value.
س: ما هو الخطأ الذي يتم إعادته إذا لم تكن الخاصية المطلوبة موجودة؟
ج: تُعيد الواجهة البرمجية حالة HTTP 404 مع جسم JSON يحتوي على Code: 404 و Status: "Property not found".
س: هل يلزم تحديد storageName عند وجود الملف في وحدة التخزين الافتراضية؟
ج: لا. مُعلَمة الاستعلام storageName اختيارية؛ يمكنك حذفها لاستخدام وحدة التخزين الافتراضية المُعدّة لحسابك.