Method: permissions.insert
یک مجوز برای یک فایل یا درایو مشترک درج می کند.
هشدار: عملیات مجوزهای همزمان در یک فایل پشتیبانی نمی‌شود. فقط آخرین به روز رسانی اعمال می شود.
درخواست HTTP
POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
fileId | string شناسه فایل یا درایو مشترک. |
پارامترهای پرس و جو
| مولفه های |
|---|
emailMessage | string یک پیام متنی ساده سفارشی برای درج در ایمیل‌های اعلان. |
enforceSingleParent
(deprecated) | boolean منسوخ شده: برای جزئیات بیشتر به moveToNewOwnersRoot مراجعه کنید. |
moveToNewOwnersRoot | boolean این پارامتر تنها در صورتی اعمال می‌شود که مورد در درایو مشترک نباشد و درخواست برای انتقال مالکیت آن مورد تلاش کند. اگر روی true تنظیم شود، مورد به پوشه ریشه My Drive مالک جدید منتقل می‌شود و تمام والدین قبلی حذف می‌شوند. اگر روی false تنظیم شود، والدین تغییر نمی کنند. |
sendNotificationEmails | boolean آیا هنگام اشتراک‌گذاری با کاربران یا گروه‌ها، ایمیل‌های اعلان ارسال شود. اگر role owner باشد، این پارامتر نادیده گرفته می‌شود و ایمیلی ارسال می‌شود. |
supportsAllDrives | boolean اینکه آیا برنامه درخواست کننده هم از My Drives و هم درایوهای مشترک پشتیبانی می کند. |
supportsTeamDrives
(deprecated) | boolean منسوخ شده: به جای آن از supportsAllDrives استفاده کنید. |
useDomainAdminAccess | boolean درخواست را به عنوان مدیر دامنه صادر کنید. اگر روی true تنظیم شود، اگر پارامتر ID فایل به یک درایو مشترک اشاره کند و درخواست کننده مدیر دامنه ای باشد که درایو مشترک به آن تعلق دارد، به درخواست کننده اجازه دسترسی داده می شود. |
درخواست بدن
بدنه درخواست حاوی نمونه‌ای از Permission است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Permission است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/docs -
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 و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-10-30 بهوقت ساعت هماهنگ جهانی."],[[["Inserts a permission for a file or shared drive, but concurrent operations on the same file aren't supported."],["Uses an HTTP POST request to `https://www.googleapis.com/drive/v2/files/{fileId}/permissions` to insert the permission."],["Requires providing `fileId` as a path parameter and allows optional query parameters like `emailMessage`, `moveToNewOwnersRoot`, and others for customization."],["The request body should contain a `Permission` object, and a successful response will return the newly created `Permission` object."],["Requires authorization with one of the following OAuth scopes: `https://www.googleapis.com/auth/docs`, `https://www.googleapis.com/auth/drive`, or `https://www.googleapis.com/auth/drive.file`."]]],["This document outlines the process of inserting a permission for a file or shared drive via a `POST` request to the Google Drive API. The request requires a `fileId` path parameter. Query parameters include options for email notifications (`sendNotificationEmails`, `emailMessage`), ownership transfer (`moveToNewOwnersRoot`), and shared drive support (`supportsAllDrives`). The request body contains permission details and successful requests return the created permission instance. Authentication requires specific OAuth scopes like `https://www.googleapis.com/auth/drive`. Concurrent permission changes are not supported.\n"]]
