نقل الملفات والمجلدات إلى المهملات أو حذفها

يمكنك إزالة ملفات ومجلدات Google Drive من "ملفاتي" ومساحات التخزين السحابي المشتركة. لديك خياران لإجراء ذلك: نقل إلى المهملات أو حذف.

يمكنك نقل الملفات والمجلدات إلى المهملات ثم استعادتها (خلال 30 يومًا من نقلها إلى المهملات). يؤدي حذف الملفات والمجلدات إلى إزالتها نهائيًا من Drive. إذا نقلت عدة ملفات أو مجلدات إلى المهملات أو استعدتها أو حذفتها نهائيًا في آنٍ واحد، قد يستغرق ظهور التغييرات بعض الوقت.

يوضّح هذا الدليل كيفية التخلص من الملفات في Drive.

استخدام المَعلمة fields

إذا أردت تحديد الحقول التي سيتم عرضها في الردّ، يمكنك ضبط المَعلمة fields system باستخدام أي طريقة من طرق المورد files. في حال حذف المَعلمة fields، يعرض الخادم مجموعة تلقائية من الحقول الخاصة بالطريقة. على سبيل المثال، تعرض الطريقة list الحقول kind وid وname وmimeType وresourceKey فقط لكل ملف. لعرض حقول مختلفة، راجِع عرض حقول محدّدة.

المهملات

لإزالة ملفات Drive، يمكنك نقلها إلى المهملات. يتم حذف الملفات من المهملات تلقائيًا بعد 30 يومًا. يمكنك استعادة الملفات من المهملات قبل مرور 30 يومًا.

يمكن لمالك الملف فقط نقله إلى المهملات، ولا يمكن للمستخدمين الآخرين عرض الملفات في مهملات المالك. إذا حاولت نقل ملف لا تملكه إلى المهملات، ستتلقّى رسالة خطأ.insufficientFilePermissions لمزيد من المعلومات، يُرجى الاطّلاع على الأذونات.

لإثبات ملكيتك للملف، استدعِ طريقة get على مورد files باستخدام مَعلمة المسار fileId والمَعلمة fields مضبوطة على الحقل المنطقي ownedByMe. لا تتم تعبئة الحقل ownedByMe للملفات في مساحات التخزين السحابي المشتركة لأنّ مساحة التخزين السحابي المشتركة هي مالكة هذه الملفات، وليس المستخدمين الفرديين. لمزيد من المعلومات عن المَعلمة fields، راجِع استخدام مَعلمة الحقول.

إذا لم تكن مالك الملف ولكنك تريد الحصول على نسخة منه، اتّبِع أحد الإجراءَين التاليَين:

  • أنشِئ نسخة من الملف.
  • تواصَل مع مالك الملف واطلب منه استعادته من المهملات.

نقل ملف إلى المهملات

لنقل ملف إلى المهملات، استخدِم طريقة update على المورد files مع مَعلمة المسار fileId واضبط الحقل المنطقي trashed على true. لنقل ملف في مساحة تخزين سحابي مشتركة إلى المهملات، يجب أيضًا ضبط مَعلمة طلب البحث المنطقية supportsAllDrives على true. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ ميزة التوافق مع مساحات التخزين السحابي المشتركة.

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال لمورد files.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام fileId لوضع علامة على الملف كملف تم نقله إلى المهملات:

Python

body_value = {'trashed': True}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': true
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

استبدِل FILE_ID بـ fileId الخاص بالملف الذي تريد نقله إلى المهملات.

تحديد خصائص ملف تم نقله إلى المهملات

عند نقل ملف إلى المهملات، يمكنك استرداد خصائص ملف إضافية. يمكنك استخدام طريقة get في مورد files مع مَعلمة المسار fileId واستخدام أحد الحقول التالية التي تم نقلها إلى المهملات في المَعلمة fields. لمزيد من المعلومات حول المَعلمة fields، راجِع مقالة استخدام مَعلمة الحقول.

يتم ملء الحقول التالية لجميع الملفات:

  • trashed: ما إذا تم نقل الملف إلى المهملات، إما بشكل صريح أو من مجلد رئيسي تم نقله إلى المهملات يُرجى العِلم أنّه أثناء استخدام trashed مع الطريقة update، يتم ضبط حالة الملف، بينما تسترد الطريقة get حالة الملف.
  • explicitlyTrashed: تُستخدَم لتحديد ما إذا تم نقل الملف إلى المهملات بشكل صريح، بدلاً من نقله بشكل متكرّر من مجلد رئيسي.

لا تتم تعبئة الحقول التالية إلا للملفات الموجودة في مساحة تخزين سحابي مشتركة:

  • ‫trashedTime: الوقت الذي تم فيه نقل العنصر إلى المهملات بتنسيق التاريخ والوقت RFC 3339 إذا كنت تستخدم الإصدار السابق من Drive API 2، يُطلق على هذا الحقل اسم trashedDate.
  • trashingUser: إذا تم نقل الملف إلى المهملات بشكل صريح، يظهر المستخدم الذي نقل الملف إلى المهملات.

استرداد ملف من المهملات

لاسترداد ملف من المهملات، استخدِم طريقة update في مورد files مع مَعلمة المسار fileId واضبط الحقل البولياني trashed على false. لاسترداد ملف من المهملات في مساحة تخزين سحابي مشتركة، يجب أيضًا ضبط المَعلمة المنطقية supportsAllDrives في طلب البحث على true. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ ميزة التوافق مع مساحات التخزين السحابي المشتركة.

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال لمورد files.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام fileId لوضع علامة على الملف بأنّه لم يتم نقله إلى المهملات:

Python

body_value = {'trashed': False}

response = drive_service.files().update(fileId="FILE_ID", body=body_value).execute()

Node.js

const body_value = {
  'trashed': false
};

const response = await drive_service.files.update({
      fileId: 'FILE_ID',
      requestBody: body_value,
    });
    return response;

استبدِل FILE_ID بـ fileId الخاص بالملف الذي تريد استرداده.

إفراغ المهملات

يمكنك حذف جميع ملفات Drive التي نقلها المستخدم إلى المهملات نهائيًا باستخدام طريقة emptyTrash في المورد files. لإفراغ مهملات مساحة تخزين سحابي مشتركة، يجب أيضًا ضبط مَعلمة طلب البحث driveId على رقم تعريف مساحة التخزين السحابي المشتركة.

في حال نجاح العملية، يحتوي نص الاستجابة على كائن JSON فارغ.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام fileId لحذف جميع الملفات في المهملات نهائيًا:

Python

response = drive_service.files().emptyTrash().execute()

Node.js

 const response = await drive_service.files.emptyTrash({
    });
    return response;

حذف

يمكنك حذف ملف في Drive نهائيًا بدون نقله إلى المهملات. بعد حذف ملف، لن يبقى بإمكان المستخدمين الذين شاركته معهم الوصول إليه. إذا أردت أن يظل بإمكان الآخرين الوصول إلى الملف، يمكنك نقل الملكية إلى مستخدم آخر قبل الحذف.

لحذف ملف في مساحة تخزين سحابي مشتركة، يجب أن يكون لدى المستخدم إذن role=organizer على المجلد الأصل. في حال حذف مجلد، سيتم أيضًا حذف جميع العناصر التابعة التي يملكها المستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على الأذونات.

لحذف ملف يملكه مستخدم نهائيًا بدون نقله إلى المهملات، استخدِم طريقة delete في مورد files. لحذف ملف في مساحة تخزين سحابي مشتركة، يجب أيضًا ضبط مَعلمة طلب البحث المنطقية supportsAllDrives على true. لمزيد من المعلومات، يُرجى الاطّلاع على تنفيذ ميزة التوافق مع مساحات التخزين السحابي المشتركة.

في حال نجاح العملية، يحتوي نص الاستجابة على كائن JSON فارغ.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام fileId لحذف الملف:

Python

response = drive_service.files().delete(fileId="FILE_ID").execute()

Node.js

 const response = await drive_service.files.delete({
      fileId: 'FILE_ID'
    });
    return response;

استبدِل FILE_ID بـ fileId الخاص بالملف الذي تريد حذفه.

الأذونات

يوضّح الجدول التالي أذونات الأدوار المطلوبة لنقل الملفات والمجلدات إلى المهملات أو حذفها. للحصول على قائمة كاملة بالأدوار والعمليات المسموح بها لكل دور، يُرجى الرجوع إلى الأدوار والأذونات.

العملية المسموح بها owner organizer fileOrganizer writer commenter reader
نقل الملفات والمجلدات إلى المهملات
استرداد الملفات والمجلدات من المهملات
إفراغ المهملات
حذف ملف أو مجلد
حذف الملفات والمجلدات في مساحة تخزين سحابي مشتركة [*]
حذف مساحة تخزين سحابي مشتركة فارغة

الإمكانات

يحتوي مورد files على مجموعة من حقول capabilities المنطقية التي تشير إلى الإمكانات التي يتمتع بها المستخدم في هذا الملف.

للتحقّق من الإمكانات، استدعِ طريقة get على مورد files باستخدام مَعلمة المسار fileId واستخدِم أحد حقول capabilities التالية في المَعلمة fields. لمزيد من المعلومات عن المَعلمة fields ، راجِع استخدام مَعلمة الحقول.

يتم ملء الحقول التالية لجميع الملفات:

  • ‫capabilities.canTrash: تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل هذا الملف إلى المهملات.
  • capabilities.canUntrash: تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي استعادة هذا الملف من المهملات.
  • capabilities.canDelete: تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي حذف هذا الملف.
  • capabilities.canRemoveChildren: تحدّد ما إذا كان بإمكان المستخدِم الحالي إزالة حسابات الأطفال من هذا المجلد. تكون القيمة false عندما لا يكون العنصر مجلدًا.

لا تتم تعبئة الحقول التالية إلا للملفات الموجودة في مساحة تخزين سحابي مشتركة:

  • ‫capabilities.canTrashChildren: تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي نقل عناصر فرعية من هذا المجلد إلى المهملات. يظهر هذا الرمز false عندما لا يكون العنصر مجلدًا.
  • capabilities.canDeleteChildren: تُستخدَم لتحديد ما إذا كان بإمكان المستخدم الحالي حذف العناصر الفرعية لهذا المجلد. يظهر هذا الرمز false عندما لا يكون العنصر مجلدًا.

الحدود القصوى المسموح بها للملفات والمجلدات

تتضمّن ملفات ومجلدات Drive، بالإضافة إلى مجلدات مساحة التخزين السحابي المشتركة، بعض حدود التخزين.

بشكل عام، بعد بلوغ الحدّ الأقصى لعدد العناصر، الطريقة الوحيدة لإتاحة مساحة أكبر هي حذف العناصر نهائيًا أو استخدام حساب مختلف. لا يكفي نقل الملفات إلى المهملات لإخلاء مساحة.

لمزيد من المعلومات حول حدود الملفات والمجلدات، يمكنك الاطّلاع على ما يلي: