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