حذف البيانات الوصفية من ملفات Excel – مستندات Aspose.Cells Cloud

نظرة عامة
تقوم عملية حذف البيانات الوصفية بإزالة جميع خصائص المصنف (القياسية والمخصصة) بشكل دائم من ملف(ات) 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 مختلفة:

واجهة برمجة تطبيقات Aspose.Cells السحابية – تحديث (ضبط) خاصية المستند إزالة جميع خصائص المستند