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

أرسِل الطلب بصفتك مشرف نطاق.

إذا تم ضبطها على true، وفي حال استيفاء الشروط الإضافية التالية، يتم منح مقدّم الطلب إذن الوصول:

  1. تشير مَعلمة رقم تعريف الملف إلى مساحة تخزين سحابي مشتركة.
  2. مقدّم الطلب هو مشرف النطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.

enforceExpansiveAccess
(deprecated)

boolean

تم إيقافها نهائيًا: تستخدم جميع الطلبات قواعد الوصول الشاملة.

نص الطلب

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

نص الاستجابة

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

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

يجب توفير أحد نطاقات OAuth التالية:

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

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