Method: permissions.create

لإنشاء إذن لملف أو مساحة تخزين سحابي مشتركة

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

طلب HTTP

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

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

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

المعلمات
fileId

string

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

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

المعلمات
emailMessage

string

رسالة مخصّصة نصية عادية لتضمينها في رسالة الإشعار الإلكترونية.

enforceSingleParent
(deprecated)

boolean

تم إيقافها نهائيًا: يُرجى الاطّلاع على moveToNewOwnersRoot لمعرفة التفاصيل.

moveToNewOwnersRoot

boolean

لن يتم تطبيق هذه المَعلمة إلا إذا لم يكن العنصر في مساحة تخزين سحابي مشتركة وكان الطلب يحاول نقل ملكية العنصر. في حال ضبط القيمة على true، سيتم نقل العنصر إلى المجلد الجذر في "ملفاتي" للمالك الجديد وإزالة جميع المجلدات الرئيسية السابقة. في حال ضبط القيمة على false، لن يتم تغيير العناصر الرئيسية.

sendNotificationEmail

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

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