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

برخی از دامنه ها محدود هستند و برای استفاده از برنامه شما به ارزیابی امنیتی نیاز دارند. برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.