لإنشاء إذن لملف أو مساحة تخزين سحابي مشتركة
تحذير: لا تتوفّر عمليات الأذونات المتزامنة على الملف نفسه، ويتم تطبيق آخر تعديل فقط.
طلب 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/drive
https://www.googleapis.com/auth/drive.file
تكون بعض النطاقات محظورة وتتطلّب تقييم أمان ليتمكّن تطبيقك من استخدامها. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.