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