Method: permissions.delete
یک مجوز را حذف می کند.
هشدار: عملیات مجوزهای همزمان در یک فایل پشتیبانی نمیشود. فقط آخرین به روز رسانی اعمال می شود.
درخواست HTTP
DELETE https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
پارامترها |
---|
fileId | string شناسه فایل یا درایو مشترک. |
permissionId | string شناسه مجوز |
پارامترهای پرس و جو
پارامترها |
---|
supportsAllDrives | boolean اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند. |
supportsTeamDrives (deprecated) | boolean منسوخ شده: به جای آن از supportsAllDrives استفاده کنید. |
useDomainAdminAccess | boolean درخواست را به عنوان مدیر دامنه صادر کنید. اگر روی true تنظیم شود، اگر پارامتر ID فایل به یک درایو مشترک اشاره کند و درخواست کننده مدیر دامنه ای باشد که درایو مشترک به آن تعلق دارد، به درخواست کننده اجازه دسترسی داده می شود. |
enforceExpansiveAccess | boolean اینکه آیا درخواست باید قوانین دسترسی گسترده را اعمال کند یا خیر. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ یک شی JSON خالی است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
برخی از دامنه ها محدود هستند و برای استفاده از برنامه شما به ارزیابی امنیتی نیاز دارند. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-02-27 بهوقت ساعت هماهنگ جهانی."],[[["This document outlines the process for deleting a permission for a file or shared drive using the Google Drive API."],["The request requires specifying the `fileId` and `permissionId` as path parameters and can optionally include query parameters like `supportsAllDrives` and `useDomainAdminAccess`."],["The request body should be empty, and upon successful deletion, the response body will also be empty."],["Authorization is required using one of the specified OAuth scopes, which might require security assessment for restricted ones."],["Concurrent permission operations are not recommended as only the last update will be applied."]]],["This document outlines the process for deleting a permission associated with a file or shared drive. The core action is a `DELETE` HTTP request to a specified URL, including `fileId` and `permissionId` as path parameters. The request body must be empty. Optional query parameters, like `supportsAllDrives` and `useDomainAdminAccess`, modify the request's behavior. Successful deletion yields an empty JSON response. It is noted that concurrent operations on the same file are unsupported. The document list the needed Authorization scopes.\n"]]