Method: permissions.update

تعديل الإذن باستخدام دلالات رموز التصحيح

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

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المَعلمات
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

تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.