Method: files.delete

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

طلب HTTP

DELETE https://www.googleapis.com/drive/v3/files/{fileId}

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
fileId

string

رقم تعريف الملف.

معلمات طلب البحث

المَعلمات
supportsAllDrives

boolean

ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة.

supportsTeamDrives
(deprecated)

boolean

متوقّفة نهائيًا: يمكنك استخدام supportsAllDrives بدلاً منها.

enforceSingleParent
(deprecated)

boolean

مهمَل: إذا لم يكن هناك عنصر في مساحة تخزين سحابي مشتركة وتم حذف آخر عنصر رئيسي له ولكن لم يتم حذف العنصر نفسه، سيتم وضع العنصر ضمن جذر مالكه.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.