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

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

enforceExpansiveAccess

boolean

ما إذا كان يجب أن يفرض الطلب قواعد وصول موسّعة

نص الطلب

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

نص الاستجابة

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

نطاقات التفويض

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

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

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