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