Documentation –

Developer-Guide: الحصول على خاصية مستند محددة

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

تقوم هذه الواجهة البرمجية للتطبيقات (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.

الطلب

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>"

الاستجابة

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

تفاصيل الاستجابة

يحتوي كائن 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 اختيارية؛ يمكنك حذفها لاستخدام وحدة التخزين الافتراضية المُعدّة لحسابك.

Developer-Guide: استرجاع البيانات الوصفية من ملفات Excel

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

تقوم هذه الواجهة REST API باسترجاع البيانات الوصفية من ملف أو أكثر من ملفات Excel.
يجب أن يتضمّن الطلب رأس Authorization: Bearer <access_token> يُحصل عليه عبر تدفق بيانات اعتماد العميل OAuth 2.0.

المتطلبات المسبقة: لاستدعاء هذه النهاية (endpoint)، يجب أن تمتلك رمز وصول (access token) ساري المفعول تم الحصول عليه من نقطة نهاية رموز OAuth 2.0 الخاصة بـ Aspose Cloud. مثال على طلب curl لاسترداد رمز وصول:

curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=<your_client_id>&client_secret=<your_client_secret>"

واجهة REST API

POST https://api.aspose.cloud/v3.0/cells/metadata/get

معلمة الاستعلام (Query Parameter)

اسم المعلمة	النوع	الوصف
type	string	`ALL` / `BuiltIn` / `Custom` – يحدّد مجموعات البيانات الوصفية المراد إعادتها.

معلمة جسم الطلب

اسم المعلمة	النوع	الوصف
ملف Excel	ملف بيانات	ملف Excel المزوّد كجزء أول من الطلب متعدد الأجزاء (multipart request).

الاستجابة

[
  {
    "Name": "Author",
    "Value": "John Doe",
    "BuiltIn": true,
    "IsReadOnly": false
  },
  {
    "Name": "CustomProp1",
    "Value": "Custom Value",
    "BuiltIn": false,
    "IsReadOnly": false
  }
]

الرمز	المعنى	الحالة
200	نجاح	تم إرجاع البيانات الوصفية.
400	طلب غير صالح	ملف مفقود أو استعلام غير صحيح.
401	غير مُصادَق عليه	رمز وصول غير صالح أو مفقود.
404	غير موجود	الملف المحدّد غير موجود.
500	خطأ داخلي في الخادم	فشل غير متوقّع في الخادم.

تُعيد الواجهة هذه الرموز القياسية لحالة HTTP مع كائن JSON للاستجابة بالخطأ عند الضرورة.

عائلة SDK في السحابة

استخدام SDK يُسرّع التطوير من خلال التعامل مع التفاصيل منخفضة المستوى. راجع مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKات مختلفة:

Developer-Guide: الحصول على جميع خصائص المستند

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

تقوم هذه الواجهة البرمجية REST بقراءة خصائص المستند.

واجهة برمجة التطبيقات GetDocumentProperties

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

الأمان والمصادقة

واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
name	string	path	اسم ملف Excel.
folder	string	query	المجلد الذي يحتوي على الملف.
storageName	string	query	اسم خدمة التخزين.

يعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة للعامة، ويسمح لك بإجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات Aspose.Cells عبر الويب. يوضح المثال التالي كيفية استدعاء واجهة برمجة التطبيقات السحابية باستخدام cURL.

Request

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

Response

{
  "DocumentProperties": {
    "DocumentPropertyList": [
      {
        "Name": "Title",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Title",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Subject",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Subject",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Author",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Author",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Keywords",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Keywords",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Comments",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Comments",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "LastSavedBy",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/LastSavedBy",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "CreateTime",
        "Value": "6/5/2015 6:17:20 PM",
        "BuiltIn": "True",
        "link": {
          "Href": "/CreateTime",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "LastSavedTime",
        "Value": "9/27/2019 9:09:43 PM",
        "BuiltIn": "True",
        "link": {
          "Href": "/LastSavedTime",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Category",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Category",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "NameOfApplication",
        "Value": "Microsoft Excel",
        "BuiltIn": "True",
        "link": {
          "Href": "/NameOfApplication",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Version",
        "Value": "16.0300",
        "BuiltIn": "True",
        "link": {
          "Href": "/Version",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Security",
        "Value": "0",
        "BuiltIn": "True",
        "link": {
          "Href": "/Security",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "ScaleCrop",
        "Value": "False",
        "BuiltIn": "True",
        "link": {
          "Href": "/ScaleCrop",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Template",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Template",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Manager",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Manager",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "Company",
        "Value": "",
        "BuiltIn": "True",
        "link": {
          "Href": "/Company",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      },
      {
        "Name": "LinksUpToDate",
        "Value": "False",
        "BuiltIn": "True",
        "link": {
          "Href": "/LinksUpToDate",
          "Rel": "self",
          "Title": null,
          "Type": null
        }
      }
    ],
    "link": {
      "Href": "/test.xlsx/documentproperties",
      "Rel": "self",
      "Title": null,
      "Type": null
    }
  },
  "Code": 200,
  "Status": "OK"
}

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تم تطبيق الفلتر بنجاح؛ يحتوي الاستجابة على تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معاملات مفقودة أو غير صحيحة (مثل نوع ملف غير مدعوم).
401	غير مصرّح به (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم البيانات كبير جدًا (Payload Too Large)	يتجاوز حجم الملف المرفوع الحد المسموح به.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

عائلة مكتبات أدوات SDK السحابية

استخدام مكتبة أدوات SDK هو أفضل طريقة لتسريع عملية التطوير. تتعامل مكتبة الأدوات SDK مع التفاصيل منخفضة المستوى وتمكنك من التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بمكتبات أدوات SDK الخاصة بـ Aspose.Cells Cloud.

توضح أمثلة الكود التالية كيفية استدعاء خدمات Aspose.Cells عبر الإنترنت باستخدام مكتبات أدوات SDK المختلفة:

Developer-Guide: تحديث البيانات الوصفية

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

تقوم هذه الواجهة REST بتحديث البيانات الوصفية في ملفات إكسل متعددة.

المتطلبات المسبقة: حساب Aspose Cloud نشط، ورمز وصول JWT صالح، وملفات إكسل المراد رفعها.

واجهة برمجة التطبيقات REST

POST https://api.aspose.cloud/v3.0/cells/metadata/update

الأمان والمصادقة

تُعد واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة تعتمد على رمز JWT.

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
file	ملف	formData	ملف إكسل المراد رفعه.
DocumentProperties	كائن	جسم الطلب (JSON)	خصائص المستند المراد تعيينها لملف إكسل.

ملاحظات: يمكن رفع ما يصل إلى 10 ملفات في طلب واحد. التنسيقات المدعومة تشمل .xlsx و.xls و.csv. ولا يجوز أن يتجاوز حجم الطلب الإجمالي 100 ميغابايت.

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات عامة قابلة للوصول، وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول إلى خدمات الويب Aspose.Cells بسهولة. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/metadata/update" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'xxxxx1=@xxxx1.xlsx' \
  -F 'xxxxx2=@xxxx2.xlsx' \
  -d '[{ "name": "test", "value": "test" }]'

يتطلب الطلب رأس Authorization يحتوي على رمز Bearer JWT. تأكد من توليد الرمز باستخدام بيانات اعتماد عميل Aspose Cloud الخاصة بك.

الاستجابة

{
  "Files": [
    {
      "Filename": "xxxxx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "xxxxx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

عائلة SDK السحابية

يُعد استخدام SDK أفضل طريقة لتسريع عملية التطوير. فتتولى SDK معالجة التفاصيل منخفضة المستوى، مما يتيح لك التركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بـ SDKs لـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات الويب Aspose.Cells باستخدام مكتبات SDK متنوعة:

انظر أيضًا:

Developer-Guide: حذف خاصية مستند محددة

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

تقوم هذه الواجهة البرمجية (REST API) بحذف خاصية مستند من ملف عمل.

واجهة برمجة تطبيقات REST

DELETE 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.

الطلب

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

الاستجابة

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

استجابات الأخطاء

حالة HTTP	الوصف	مثال JSON
400	طلب غير صحيح – معلمات مطلوبة مفقودة أو قيم غير صالحة.	`{"Code":400,"Message":"Missing required parameter 'name'."}`
401	غير مصرح به – رمز JWT غير صالح أو غير موجود.	`{"Code":401,"Message":"Invalid access token."}`
404	غير موجود – ملف العمل أو الخاصية المحددة غير موجود.	`{"Code":404,"Message":"Document property not found."}`
500	خطأ داخلي في الخادم – حدثت حالة غير متوقعة على الخادم.	`{"Code":500,"Message":"An unexpected error has occurred."}`

عائلة وحدات التحكم (SDK) السحابية

استخدام وحدة التحكم (SDK) هو أفضل طريقة لتسريع عملية التطوير. فوحدات التحكم تتعامل مع التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للحصول على قائمة كاملة بوحدات تحكم Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية إجراء مكالمات لخدمات الويب الخاصة بـ Aspose.Cells باستخدام مختلف وحدات التحكم (SDKs):

Developer-Guide: حذف البيانات الوصفية من ملفات Excel

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

نظرة عامة
تقوم عملية حذف البيانات الوصفية بإزالة جميع خصائص المصنف (القياسية والمخصصة) بشكل دائم من ملف(ات) Excel المرفوع وتعيد الملف(ات) المعالَج(ة) في الاستجابة.

المتطلبات المسبقة

رمز JWT صالح لـ Aspose.Cells Cloud (يمكن الحصول عليه عبر تدفق مصادقة OAuth 2.0).
إصدار واجهة برمجة التطبيقات v3.0 (نقطة النهاية المستخدمة في هذا المثال).
لاستخدام SDKs، ثبّت SDK المناسب لـ Aspose.Cells Cloud بلغة برمجتك (مثلًا عبر NuGet أو Maven أو npm أو pip أو CPAN أو وحدات Go).

تقوم هذه واجهة برمجة تطبيقات REST بحذف البيانات الوصفية من ملف(ات) Excel واحدة أو أكثر. وتزيل خصائص المصنف مثل المؤلف والعنوان والبيانات المخصصة، ثم تعيد الملفات النظيفة.

واجهة برمجة التطبيقات

POST https://api.aspose.cloud/v3.0/cells/metadata/delete

الأمان والمصادقة

واجهات برمجة تطبيقات Aspose.Cells Cloud آمنة وتتطلب مصادقة مبنية على رمز JWT.

معاملات الطلب

اسم المعامل	النوع	الموقع	الوصف
file	ملف	formData	ملف Excel المراد رفعه لحذف البيانات الوصفية
type	نص	استعلام	نوع العملية؛ ضعها على all لحذف جميع البيانات الوصفية

يُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات قابلة للوصول عامًا وتتيح لك إجراء تفاعلات REST مباشرة من متصفح الويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات ويب Aspose.Cells. يوضح المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.

الطلب

curl -v "https://api.aspose.cloud/v3.0/cells/metadata/delete?type=all" \
  -X POST \
  -H "Authorization: Bearer <jwt token>" \
  -F "file=@file1.xlsx"

الاستجابة

{
  "Files": [
    {
      "Filename": "file1.xlsx",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

قد تشمل استجابات الخطأ ما يلي:

400 طلب غير صالح – ملف مفقود أو قيمة type غير صحيحة.
401 غير مخوّل – رمز JWT غير صالح أو مفقود.
500 خطأ داخلي في الخادم – خطأ في معالجة الخادم من الجهة الخلفية.

تعيد واجهة برمجة التطبيقات كائن JSON يحتوي على حقل Error يحتوي على التفاصيل لكل حالة.

الرمز	المعنى	الوصف
200	نجاح	تم حذف البيانات الوصفية، وتم إعادة الملف
400	طلب غير صالح	ملف مفقود أو `type` غير صالح
401	غير مخوّل	رمز JWT غير صالح أو مفقود
500	خطأ داخلي في الخادم	فشل في معالجة الخادم

عائلة SDK السحابية

استخدام SDK هو أفضل طريقة لتسريع عملية التطوير. يتعامل SDK مع التفاصيل منخفضة المستوى، مما يسمح لك بالتركيز على مهام مشروعك. يُرجى الاطلاع على مستودع GitHub للاطّلاع على قائمة كاملة بـ SDKs لـ Aspose.Cells Cloud.

توضح أمثلة الرمز التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام SDKs مختلفة:

Developer-Guide: إزالة جميع خصائص المستند

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

تقوم هذه الواجهة البرمجية لـ REST بحذف جميع الخصائص المخصصة للمستند ومسح الخصائص المدمجة.

واجهة برمجة تطبيقات REST

DELETE http://api.aspose.cloud/v3.0/cells/{name}/documentproperties

معلمات الطلب

اسم المعلمة	النوع	الموقع	الوصف
name	string	path	اسم المستند.
folder	string	query	مجلد المستند.
storageName	string	query	اسم التخزين.

تُعرّف مواصفات OpenAPI واجهة برمجة تطبيقات متاحة علنًا وتتيح لك إجراء تفاعلات REST مباشرة من متصفح ويب.

يمكنك استخدام أداة سطر الأوامر cURL للوصول بسهولة إلى خدمات الويب الخاصة بـ Aspose.Cells. يُظهر المثال التالي كيفية إجراء مكالمات لواجهة برمجة التطبيقات السحابية باستخدام cURL.

Request

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

Response

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

عائلة حزم تطوير البرمجيات السحابية

استخدام حزمة تطوير البرمجيات (SDK) هو أفضل طريقة لتسريع عملية التطوير. تتعامل حزمة تطوير البرمجيات مع التفاصيل منخفضة المستوى وتركّز أنت على مهام مشروعك. يُرجى الاطّلاع على مستودع GitHub للحصول على قائمة كاملة بحزم تطوير البرمجيات الخاصة بـ Aspose.Cells Cloud.

تُظهر أمثلة الكود التالية كيفية استدعاء خدمات ويب Aspose.Cells باستخدام حزم تطوير برامج مختلفة:

Developer-Guide: واجهة برمجة تطبيقات Aspose.Cells السحابية – تحديث (ضبط) خاصية المستند

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

نظرة عامة

تتيح لك عملية تحديث (ضبط) خاصية المستند إنشاء خاصية مستند جديدة أو تعديل خاصية موجودة مسبقًا في ملف Excel مخزن في وحدة تخزين Aspose Cloud.

نقطة النهاية (Endpoint)
PUT https://api.aspose.cloud/v3.0/cells/{name}/documentproperties/{propertyName}

يقبل الطلب حمولة JSON تصف الخاصية المراد ضبطها.

المتطلبات الأساسية

رمز وصول JWT صالح (انظر قسم المصادقة).
يجب أن يكون ملف المصنف المستهدف ({name}) موجودًا بالفعل في وحدة تخزين Aspose Cloud (أو في مجلد تحدده).
اسم وحدة التخزين (storageName) اختياري؛ وفي حال حذفه، سيُستخدم وحدة التخزين الافتراضية.

المصادقة

تستخدم Aspose.Cells Cloud المصادقة القائمة على رموز JWT. يجب تضمين الرمز في رأس Authorization:

Authorization: Bearer <jwt-token>

لمزيد من التفاصيل حول كيفية الحصول على رمز JWT، راجع دليل المصادقة.

طلب HTTP

العنصر	القيمة
طريقة الطلب	`PUT`
عنوان URI	`/cells/{name}/documentproperties/{propertyName}`
نوع المحتوى (Content-Type)	`application/json`
النوع المقبول (Accept)	`application/json`

معلمات المسار (Path Parameters)

الاسم	النوع	الإجبارية	الوصف
`name`	نص (string)	✅	اسم ملف Excel (مع امتداد الملف).
`propertyName`	نص (string)	✅	اسم خاصية المستند التي سيتم ضبطها أو إنشاؤها.

معلمات الاستعلام (Query Parameters)

الاسم	النوع	الإجبارية	الوصف
`folder`	نص (string)	❌	مسار المجلد داخل وحدة التخزين حيث يوجد ملف المصنف.
`storageName`	نص (string)	❌	اسم خدمة التخزين. وفي حال حذفه، سيُستخدم وحدة التخزين الافتراضية.

جسم الطلب – كائن خاصية المستند

{
  "Name": "author",
  "Value": "aspose",
  "BuiltIn": "string",          // اختياري، مثلًا: "true" أو "false"
  "Link": {                     // اختياري
    "Href": "string",
    "Rel": "string",
    "Title": "string",
    "Type": "string"
  }
}

الحقل	النوع	الإجبارية	الوصف
Name	نص (string)	✅	اسم الخاصية (مثلًا: `author`).
Value	نص (string)	✅	قيمة الخاصية.
BuiltIn	نص (string)	❌	يشير إلى ما إذا كانت الخاصية مدمجة.
Link	كائن (object)	❌	معلومات الارتباط التشعبي (`Href`, `Rel`, `Title`, `Type`).

مثال على الطلب (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/documentproperties/author?folder=Docs&storageName=MyStorage" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt-token>" \
  -d '{
        "Name": "author",
        "Value": "aspose",
        "BuiltIn": "false",
        "Link": {
          "Href": "https://example.com",
          "Rel": "self",
          "Title": "Author link",
          "Type": "text/html"
        }
      }'

مثال على استجابة ناجحة

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

رموز حالة HTTP

الرمز	المعنى	الوصف
200	ناجح (OK)	تم تطبيق الفلتر بنجاح؛ وتتضمن الاستجابة تفاصيل العملية.
400	طلب غير صالح (Bad Request)	معلمات مفقودة أو غير صالحة (مثلًا: نوع ملف غير مدعوم).
401	غير مصادق عليه (Unauthorized)	رمز JWT غير صالح أو مفقود.
413	حجم الحمولة كبير جدًا (Payload Too Large)	حجم الملف المرفوع يتجاوز الحد المسموح.
500	خطأ داخلي في الخادم (Internal Server Error)	خطأ غير متوقع في الخادم.

أمثلة لواجهات برمجة التطبيقات (SDKs)

توضح مقاطع الكود التالية كيفية استدعاء هذه العملية باستخدام واجهات برمجة تطبيقات Aspose.Cells Cloud الرسمية.

اللغة	المثال
C#	عرض مثال C# csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar apiInstance = new DocumentPropertiesApi();\nvar request = new PutDocumentPropertyRequest(\n name: "test.xlsx",\n propertyName: "author",\n property: new CellsDocumentProperty {\n Name = "author",\n Value = "aspose",\n BuiltIn = "false",\n Link = new Link {\n Href = "https://example.com",\n Rel = "self",\n Title = "Author link",\n Type = "text/html"\n }\n },\n folder: "Docs",\n storageName: "MyStorage"\n);\nvar response = apiInstance.PutDocumentProperty(request);\nConsole.WriteLine(response.Status);\n\n
Java	عرض مثال Java java\nimport com.aspose.cells.cloud.api.DocumentPropertiesApi;\nimport com.aspose.cells.cloud.model.*;\n\nDocumentPropertiesApi api = new DocumentPropertiesApi();\nCellsDocumentProperty prop = new CellsDocumentProperty();\nprop.setName("author");\nprop.setValue("aspose");\nprop.setBuiltIn("false");\nLink link = new Link();\nlink.setHref("https://example.com");\nlink.setRel("self");\nlink.setTitle("Author link");\nlink.setType("text/html");\nprop.setLink(link);\n\nPutDocumentPropertyRequest request = new PutDocumentPropertyRequest("test.xlsx", "author", prop, "Docs", "MyStorage");\nCellsCloudResponse response = api.putDocumentProperty(request);\nSystem.out.println(response.getStatus());\n\n
Python	عرض مثال Python `python\nfrom asposecellscloud import DocumentPropertiesApi, CellsDocumentProperty, Link\n\napi = DocumentPropertiesApi()\nprop = CellsDocumentProperty(name="author", value="aspose", built_in="false")\nprop.link = Link(href="https://example.com", rel="self", title="Author link", type="text/html")\nresponse = api.put_document_property(name="test.xlsx", property_name="author", property=prop, folder="Docs", storage_name="MyStorage")\nprint(response.status)\n`\n
Node.js	عرض مثال Node.js javascript\nconst { DocumentPropertiesApi, CellsDocumentProperty, Link } = require('asposecellscloud');\n\nconst api = new DocumentPropertiesApi();\nconst prop = new CellsDocumentProperty({\n name: 'author',\n value: 'aspose',\n builtIn: 'false',\n link: new Link({ href: 'https://example.com', rel: 'self', title: 'Author link', type: 'text/html' })\n});\n\napi.putDocumentProperty({\n name: 'test.xlsx',\n propertyName: 'author',\n property: prop,\n folder: 'Docs',\n storageName: 'MyStorage'\n}).then(res => console.log(res.status));\n\n
Go	عرض مثال Go go\nimport (\n "context"\n cells "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"\n)\n\napi := cells.NewDocumentPropertiesApi()\nprop := cells.CellsDocumentProperty{Name: "author", Value: "aspose", BuiltIn: "false"}\nprop.Link = &cells.Link{Href: "https://example.com", Rel: "self", Title: "Author link", Type: "text/html"}\nreq := cells.PutDocumentPropertyRequest{Name: "test.xlsx", PropertyName: "author", Property: &prop, Folder: "Docs", StorageName: "MyStorage"}\nresp, _, err := api.PutDocumentProperty(context.Background(), req)\nif err != nil { panic(err) }\nfmt.Println(resp.Status)\n\n
Ruby	عرض مثال Ruby `ruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::DocumentPropertiesApi.new\nprop = AsposeCellsCloud::CellsDocumentProperty.new(\n name: 'author',\n value: 'aspose',\n built_in: 'false',\n link: AsposeCellsCloud::Link.new(\n href: 'https://example.com',\n rel: 'self',\n title: 'Author link',\n type: 'text/html'\n )\n)\nresponse = api.put_document_property('test.xlsx', 'author', prop, folder: 'Docs', storage_name: 'MyStorage')\nputs response.status\n`\n
PHP	عرض مثال PHP php\n<?php\nuse Aspose\Cells\DocumentPropertiesApi;\nuse Aspose\Cells\Model\CellsDocumentProperty;\nuse Aspose\Cells\Model\Link;\n\n$api = new DocumentPropertiesApi();\n$prop = new CellsDocumentProperty([\n 'Name' => 'author',\n 'Value' => 'aspose',\n 'BuiltIn' => 'false',\n 'Link' => new Link([\n 'Href' => 'https://example.com',\n 'Rel' => 'self',\n 'Title' => 'Author link',\n 'Type' => 'text/html'\n ])\n]);\n$response = $api->putDocumentProperty('test.xlsx', 'author', $prop, 'Docs', 'MyStorage');\necho $response->getStatus();\n?>\n\n
Perl	عرض مثال Perl perl\nuse AsposeCellsCloud::DocumentPropertiesApi;\nuse AsposeCellsCloud::Object::CellsDocumentProperty;\nuse AsposeCellsCloud::Object::Link;\n\nmy $api = AsposeCellsCloud::DocumentPropertiesApi->new();\nmy $prop = AsposeCellsCloud::Object::CellsDocumentProperty->new(\n Name => 'author',\n Value => 'aspose',\n BuiltIn => 'false',\n Link => AsposeCellsCloud::Object::Link->new(\n Href => 'https://example.com',\n Rel => 'self',\n Title => 'Author link',\n Type => 'text/html'\n )\n);\nmy $response = $api->put_document_property(name => 'test.xlsx', property_name => 'author', property => $prop, folder => 'Docs', storage_name => 'MyStorage');\nprint $response->{Status}, \"\\n\";\n\n

روابط ذات صلة

مواصفات OpenAPI: https://apireference.aspose.cloud/cells/#/Properties/PutDocumentProperty (يفتح في علامة تبويب جديدة، rel="noopener noreferrer").
دليل المصادقة: https://docs.aspose.cloud/total/getting-started/rest-api-overview/authenticating-api-requests/ (يفتح في علامة تبويب جديدة، rel="noopener noreferrer").
واجهات برمجة تطبيقات Aspose.Cells Cloud (SDKs): https://github.com/aspose-cells-cloud (يفتح في علامة تبويب جديدة، rel="noopener noreferrer").