Method: permissions.update

یک مجوز را به‌روزرسانی می‌کند.

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

درخواست HTTP

PUT https://www.googleapis.com/drive/v2/files/{fileId}/permissions/{permissionId}

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

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

پارامترها
fileId

string

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

permissionId

string

مدرک شناسایی برای دریافت مجوز.

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

پارامترها
removeExpiration

boolean

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

supportsAllDrives

boolean

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

supportsTeamDrives
(deprecated)

boolean

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

transferOwnership

boolean

اینکه آیا تغییر نقش به owner مالکان فعلی را به نویسندگان تنزل رتبه می‌دهد یا خیر. اگر نقش مشخص شده owner نباشد، هیچ کاری انجام نمی‌دهد.

useDomainAdminAccess

boolean

درخواست را به عنوان مدیر دامنه ارسال کنید؛ اگر روی درست تنظیم شود، در صورتی که پارامتر شناسه فایل به یک درایو مشترک اشاره کند و درخواست‌کننده مدیر دامنه‌ای باشد که درایو مشترک به آن تعلق دارد، به درخواست‌کننده دسترسی داده می‌شود.

enforceExpansiveAccess
(deprecated)

boolean

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

درخواست بدنه

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

بدنه پاسخ

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

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

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

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

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