Method: permissions.update

تعدِّل إذنًا باستخدام الدلالات الدلالية.

تحذير: لا تتوفّر عمليات الأذونات المتزامنة على الملف نفسه، ويتم تطبيق التعديل الأخير فقط.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المعلّمات
fileId

string

رقم تعريف الملف أو مساحة التخزين السحابي المشتركة.

permissionId

string

رقم تعريف الإذن.

معامِلات طلب البحث

المعلّمات
removeExpiration

boolean

ما إذا كان يجب إزالة تاريخ انتهاء الصلاحية.

supportsAllDrives

boolean

ما إذا كان التطبيق الذي يقدِّم الطلب يتيح استخدام "ملفاتي" ومساحات التخزين السحابي المشتركة.

supportsTeamDrives
(deprecated)

boolean

تم الإيقاف: استخدِم supportsAllDrives بدلاً من ذلك.

transferOwnership

boolean

لتحديد ما إذا كنت تريد نقل الملكية إلى المستخدم المحدد وخفض مستوى المالك الحالي إلى كاتب. هذه المعلّمة مطلوبة كإقرار بالآثار الجانبية.

useDomainAdminAccess

boolean

عليك إصدار الطلب بصفتك مشرفًا للنطاق. في حال ضبط هذه السياسة على "صحيح"، سيتم منح مقدِّم الطلب إذن الوصول إذا كانت معلّمة معرّف الملف تشير إلى مساحة تخزين سحابي مشتركة وكان مقدّم الطلب مشرفًا للنطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة.

نص الطلب

يحتوي نص الطلب على مثال Permission.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Permission.

نطاقات الأذونات

يتطلب ذلك أحد نطاقات OAuth التالية:

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

بعض النطاقات مقيَّدة وتتطلَّب تقييم أمان لكي يستخدمها تطبيقك. لمزيد من المعلومات، اطّلِع على دليل التفويض.