Method: permissions.create

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

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

طلب HTTP

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

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

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

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

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