حماية جداول البيانات – تعيين كلمة مرور الفتح وكلمة مرور التعديل

في هذا الدليل، ستتعلم كيفية تعيين وتعديل وإزالة كلمة مرور الفتح وكلمة مرور القراءة/الكتابة لجداول البيانات باستخدام واجهة Aspose.Cells Cloud Web API. تُساعدك هذه الميزات في حماية البيانات الحساسة الموجودة في ملفات عمل Excel الخاصة بك.

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

حساب نشط على Aspose.Cells Cloud مع مفتاح API وSID ساري المفعول.
يجب أن يكون ملف العمل الذي ترغب في حمايته مُحمّلًا على مساحة التخزين في Aspose Cloud أو متاحًا عبر رابط عام.

مرجع الواجهة البرمجية (API)

طريقة HTTP	النهاية (Endpoint)	المُعلمات (Query / Path)	الوصف
`PUT`	`/cells/{fileName}/protection`	`fileName` (مسار) – اسم ملف العمل `openPassword` (استعلام، اختياري) – كلمة المرور المطلوبة لفتح الملف `readWritePassword` (استعلام، اختياري) – كلمة المرور المطلوبة لتعديل الملف	تعيين أو تحديث كلمات مرور الفتح و/أو قراءة/كتابة لملف العمل المحدد.
`DELETE`	`/cells/{fileName}/protection`	`fileName` (مسار) – اسم ملف العمل	إزالة أي كلمات مرور تحمي ملف العمل.

مثال على جسم الطلب (JSON)

{
  "OpenPassword": "MyOpenPwd123",
  "ReadWritePassword": "MyEditPwd456"
}

مثال على الاستجابة (JSON)

{
  "Code": 200,
  "Status": "OK",
  "Message": "تم تحديث حماية ملف العمل بنجاح."
}

رموز حالة HTTP

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

أمثلة على الأكواد

C# (SDK لـ Aspose.Cells Cloud)

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var apiInstance = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
var request = new SetWorkbookProtectionRequest(
    name: "Sample.xlsx",
    openPassword: "MyOpenPwd123",
    readWritePassword: "MyEditPwd456"
);
apiInstance.SetWorkbookProtection(request);

Python (SDK لـ Aspose.Cells Cloud)

import asposecellscloud
from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.models import SetWorkbookProtectionRequest

api = CellsApi(client_id="YOUR_CLIENT_ID", client_secret="YOUR_CLIENT_SECRET")
request = SetWorkbookProtectionRequest(
    name="Sample.xlsx",
    open_password="MyOpenPwd123",
    read_write_password="MyEditPwd456"
)
api.set_workbook_protection(request)

إدارة الأخطاء
عند حدوث خطأ، تُعيد الواجهة البرمجية جسم JSON يحتوي على Code وMessage، وربما Description. تحقق من رمز الحالة وتعامل معه وفقًا لمنطق تطبيقك.