Method: files.delete

يحذف هذا الإجراء نهائيًا ملفًا يملكه المستخدم بدون نقله إلى المهملات. لمزيد من المعلومات، يُرجى الاطّلاع على files.trash أو حذف الملفات والمجلدات.

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

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
supportsAllDrives

boolean

تحديد ما إذا كان التطبيق الذي يطلب الوصول يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة
supportsTeamDrives
(deprecated)

boolean

تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة supportsAllDrives بدلاً منها.
enforceSingleParent
(deprecated)

boolean

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

نص الطلب

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

نص الاستجابة

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

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

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

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