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

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