Method: files.trash
یک فایل را به سطل زباله منتقل می کند. کاربر تأیید شده فعلی باید مالک فایل باشد یا حداقل یک fileOrganizer در والد برای فایل‌های درایو مشترک باشد.
درخواست HTTP
POST https://www.googleapis.com/drive/v2/files/{fileId}/trash
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
fileId | string شناسه فایل در سطل زباله. |
پارامترهای پرس و جو
| مولفه های |
|---|
supportsAllDrives | boolean اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند. |
supportsTeamDrives
(deprecated) | boolean منسوخ شده: به جای آن از supportsAllDrives استفاده کنید. |
includePermissionsForView | string مشخص می کند که کدام مجوزهای اضافی در پاسخ گنجانده شود. فقط published پشتیبانی می شود. |
includeLabels | string فهرستی از شناسه‌های برچسب‌هایی که با کاما از هم جدا شده‌اند تا در قسمت labelInfo پاسخ قرار داده شوند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از File است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/docs -
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.appdata -
https://www.googleapis.com/auth/drive.apps.readonly -
https://www.googleapis.com/auth/drive.file
برخی از دامنه ها محدود هستند و برای استفاده از برنامه شما به ارزیابی امنیتی نیاز دارند. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی."],[[["Permanently moves a file to the trash, requiring the user to own the file or have sufficient permissions."],["Uses an HTTP POST request with the file ID as a path parameter to specify the target file."],["Allows optional query parameters to control behavior regarding shared drives, permissions, and labels."],["Requires authorization with specific OAuth scopes, including `https://www.googleapis.com/auth/drive` or similar, for access."],["Returns a File resource describing the trashed file upon successful completion."]]],["This content describes how to move a file to the trash using the Google Drive API. The process involves sending a `POST` request to `https://www.googleapis.com/drive/v2/files/{fileId}/trash`, where `fileId` is the file's ID. The request body must be empty, and optional query parameters like `supportsAllDrives` or `includeLabels` can be added. Successful requests return a `File` instance in the response. Authorization requires specific OAuth scopes, such as `https://www.googleapis.com/auth/drive`. The user must own the file.\n"]]
