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

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

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

ملاحظة: في هذا المستند، يُفترض أنّ مصطلح "الملفات" يعني الملفات والمجلدات على حد سواء. المجلدات هي ملفات لا تحتوي إلا على بيانات وصفية ويمكن استخدامها لتنظيم الملفات في Drive. على وجه التحديد، المجلد هو ملف بدون امتداد و نوع MIME هو application/vnd.google-apps.folder. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إنشاء ملفات تحتوي على بيانات وصفية فقط.

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

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

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

المهملات

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

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

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

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

• إنشاء نسخة من الملف
• التواصل مع مالك الملف وطلب استعادته من المهملات

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

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

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

ملاحظة: إذا كنت تستخدم الإصدار السابق من Drive API v2، استخدِم طريقة trash في مصدر files. تعرّف على كيفية النقل إلى Drive API v3.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام 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، يُرجى الاطّلاع على مقالة استخدام مَعلمة fields.

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

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

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

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

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

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

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

ملاحظة: إذا كنت تستخدم الإصدار السابق من Drive API v2، استخدِم طريقة untrash في مصدر files. تعرّف على كيفية النقل إلى Drive API v3.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام 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`.emptyTrashfiles لإفراغ مهملات مساحة تخزين سحابي مشتركة، يجب أيضًا ضبط مَعلمة طلب البحث driveIdعلى رقم تعريف مساحة التخزين السحابي المشتركة.

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

ملاحظة: إذا كنت تستخدم الإصدار السابق من Drive API v2، استخدِم طريقة emptyTrash في مصدر files. تعرّف على كيفية النقل إلى Drive API v3.

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

ملاحظة: إذا كنت تستخدم الإصدار السابق من Drive API v2، استخدِم طريقة delete في مصدر files. تعرّف على كيفية النقل إلى Drive API v3.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام 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
نقل الملفات والمجلدات إلى المهملات
استرداد الملفات والمجلدات من المهملات
إفراغ المهملات
حذف ملف أو مجلد
حذف الملفات والمجلدات في مساحة تخزين سحابي مشتركة ^[*]
حذف مساحة تخزين سحابي مشتركة فارغة

[*] يتطلب دور organizer في عنصر رئيسي مباشر أو غير مباشر، بدلاً من أن يكون الدور متوفرًا في العنصر.

الإمكانات

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

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

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

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

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

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

حدود الملفات والمجلدات

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

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

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

• حدود الملفات والمجلدات في الملفات
• حدود المجلدات في مساحات التخزين السحابي المشتركة

مواضيع ذات صلة

• حذف الملفات في Google Drive
• الاختلافات بين واجهة برمجة التطبيقات لمساحات التخزين السحابي المشتركة وواجهة برمجة التطبيقات "ملفاتي"
• الأدوار والأذونات