Method: permissions.update

یک مجوز را با استفاده از معانی وصله به‌روزرسانی می‌کند. برای اطلاعات بیشتر، به بخش اشتراک‌گذاری فایل‌ها، پوشه‌ها و درایوها مراجعه کنید.

هشدار: عملیات مجوز همزمان روی یک فایل پشتیبانی نمی‌شود؛ فقط آخرین به‌روزرسانی اعمال می‌شود.

درخواست HTTP

PATCH https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
fileId

string

شناسه فایل یا درایو مشترک.

permissionId

string

شناسه مجوز.

پارامترهای پرس و جو

پارامترها
removeExpiration

boolean

آیا تاریخ انقضا حذف شود یا خیر.

supportsAllDrives

boolean

اینکه آیا برنامه درخواست‌کننده از هر دو درایوهای من و درایوهای اشتراکی پشتیبانی می‌کند یا خیر.

supportsTeamDrives
(deprecated)

boolean

منسوخ شده: به جای آن supportsAllDrives استفاده کنید.

transferOwnership

boolean

اینکه آیا مالکیت به کاربر مشخص شده منتقل شود و مالک فعلی به نویسنده تنزل یابد یا خیر. این پارامتر به عنوان تأیید اثر جانبی مورد نیاز است. برای اطلاعات بیشتر، به انتقال مالکیت فایل مراجعه کنید.

useDomainAdminAccess

boolean

درخواست را به عنوان مدیر دامنه ارسال کنید.

اگر روی true تنظیم شود، و اگر شرایط اضافی زیر برقرار باشند، به درخواست‌کننده دسترسی داده می‌شود:

  1. پارامتر شناسه فایل به یک درایو مشترک اشاره دارد.
  2. درخواست‌کننده، مدیر دامنه‌ای است که درایو اشتراکی به آن تعلق دارد.

برای اطلاعات بیشتر، به مدیریت درایوهای مشترک به عنوان مدیر دامنه مراجعه کنید.

enforceExpansiveAccess
(deprecated)

boolean

منسوخ شده: همه درخواست‌ها از قوانین دسترسی گسترده استفاده می‌کنند.

درخواست بدنه

بدنه درخواست شامل نمونه‌ای از Permission است.

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل نمونه‌ای از Permission است.

دامنه‌های مجوز

به یکی از حوزه‌های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

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