Method: revisions.delete
يحذف نسخة من الملف نهائيًا. يمكنك حذف النُسخ السابقة فقط للملفات التي تتضمّن محتوى ثنائيًا في Google Drive، مثل الصور أو الفيديوهات. لا يمكن حذف النُسخ السابقة من الملفات الأخرى، مثل "مستندات Google" أو "جداول بيانات Google" وآخر نسخة متبقية من الملف.
طلب HTTP
DELETE https://www.googleapis.com/drive/v3/files/{fileId}/revisions/{revisionId}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
fileId |
string
رقم تعريف الملف.
|
revisionId |
string
رقم تعريف النسخة السابقة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
في حال نجاح هذا الإجراء، يكون نص الاستجابة فارغًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Permanently deletes a specific version of a file in Google Drive, applicable only to files with binary content like images or videos."],["This action is not possible for revisions of Google Docs, Sheets, or the last remaining version of any file."],["Requires authorization with specific scopes such as `https://www.googleapis.com/auth/drive`, `https://www.googleapis.com/auth/drive.appdata`, or `https://www.googleapis.com/auth/drive.file`."],["The request body should be empty and a successful operation results in an empty response body."],["Uses a DELETE request to `https://www.googleapis.com/drive/v3/files/{fileId}/revisions/{revisionId}` specifying the file and revision IDs as path parameters."]]],["This document outlines the process for permanently deleting a file version in Google Drive. A `DELETE` HTTP request is sent to a specific URL containing `fileId` and `revisionId` path parameters. The request body must be empty. Successful deletion, applicable only to binary content files (e.g., images, videos), results in an empty response body. The operation requires specific OAuth scopes for authorization, including `drive`, `drive.appdata`, or `drive.file`. Revisions for non-binary files or the last remaining version cannot be deleted.\n"]]
