ينشئ إذنًا لملف أو مساحة تخزين سحابي مشتركة.
تحذير: لا تتوفر عمليات الأذونات المتزامنة في الملف نفسه، ويتم تطبيق التعديل الأخير فقط.
طلب HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات | |
|---|---|
fileId |
رقم تعريف الملف أو مساحة التخزين السحابي المشتركة |
معلمات طلب البحث
| المَعلمات | |
|---|---|
emailMessage |
رسالة نصية عادية مخصصة لتضمينها في إشعار البريد الإلكتروني. |
enforceSingleParent |
متوقّفة نهائيًا: يُرجى الاطّلاع على |
moveToNewOwnersRoot |
لن تسري هذه المَعلمة إلا إذا لم يكن العنصر في مساحة تخزين سحابي مشتركة وكان الطلب يحاول نقل ملكية العنصر. في حال ضبط هذه السياسة على |
sendNotificationEmail |
يمكنك اختيار ما إذا كنت تريد إرسال إشعار عبر البريد الإلكتروني عند المشاركة مع مستخدمين أو مجموعات. يتم ضبط الإعداد التلقائي على "صحيح" للمستخدمين والمجموعات، ولا يُسمح به في الطلبات الأخرى. ويجب عدم إيقاف هذا الخيار لعمليات نقل الملكية. |
supportsAllDrives |
ما إذا كان التطبيق الذي يقدّم الطلب متوافقًا مع كل من "ملفاتي" ومساحات التخزين السحابي المشتركة. |
supportsTeamDrives |
متوقّفة نهائيًا: يمكنك استخدام |
transferOwnership |
تحدّد هذه العلامة ما إذا كان سيتم نقل الملكية إلى المستخدم المحدّد وخفض مستوى المالك الحالي إلى كاتب. هذه المَعلمة مطلوبة كإقرار بالأثر الجانبي. |
useDomainAdminAccess |
أصدر الطلب كمشرف نطاق. في حال ضبط هذه السياسة على "صحيح"، سيتم منح مقدِّم الطلب إذن الوصول إذا كانت مَعلمة رقم تعريف الملف تشير إلى مساحة تخزين سحابي مشترَكة، وكان مقدِّم الطلب مشرفًا على النطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة. |
نص الطلب
يحتوي نص الطلب على مثال Permission.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Permission تم إنشاؤه حديثًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.file
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.