برای یک فایل یا درایو مشترک، مجوز ایجاد میکند. برای اطلاعات بیشتر، به اشتراکگذاری فایلها، پوشهها و درایوها مراجعه کنید.
هشدار: عملیات مجوز همزمان روی یک فایل پشتیبانی نمیشود؛ فقط آخرین بهروزرسانی اعمال میشود.
درخواست HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
fileId | شناسه فایل یا درایو مشترک. |
پارامترهای پرس و جو
| پارامترها | |
|---|---|
emailMessage | یک پیام متنی سفارشی ساده برای قرار دادن در ایمیل اعلان. |
enforceSingleParent | منسوخ شده: برای جزئیات بیشتر به |
moveToNewOwnersRoot | این پارامتر فقط در صورتی اعمال میشود که آیتم در درایو مشترک نباشد و درخواست سعی در انتقال مالکیت آیتم داشته باشد. اگر روی |
sendNotificationEmail | اینکه آیا هنگام اشتراکگذاری به کاربران یا گروهها، ایمیل اعلان ارسال شود یا خیر. این گزینه برای کاربران و گروهها به صورت پیشفرض روی |
supportsAllDrives | اینکه آیا برنامه درخواستکننده از هر دو درایوهای من و درایوهای اشتراکی پشتیبانی میکند یا خیر. |
supportsTeamDrives | منسوخ شده: به جای آن |
transferOwnership | اینکه آیا مالکیت به کاربر مشخص شده منتقل شود و مالک فعلی به نویسنده تنزل یابد یا خیر. این پارامتر به عنوان تأیید اثر جانبی مورد نیاز است. برای اطلاعات بیشتر، به انتقال مالکیت فایل مراجعه کنید. |
useDomainAdminAccess | درخواست را به عنوان مدیر دامنه ارسال کنید. اگر روی
برای اطلاعات بیشتر، به مدیریت درایوهای مشترک به عنوان مدیر دامنه مراجعه کنید. |
enforceExpansiveAccess | منسوخ شده: همه درخواستها از قوانین دسترسی گسترده استفاده میکنند. |
درخواست بدنه
بدنه درخواست شامل نمونهای از Permission است.
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل یک نمونه تازه ایجاد شده از Permission است.
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.file
برخی از حوزهها محدود شدهاند و برای استفاده برنامه شما از آنها، ارزیابی امنیتی لازم است. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.