يدرج إذنًا لملف أو مساحة تخزين سحابي مشتركة.
تحذير: لا تتوفر عمليات الأذونات المتزامنة في الملف نفسه، ويتم تطبيق التعديل الأخير فقط.
طلب 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
تكون بعض النطاقات محظورة وتتطلب تقييمًا أمنيًا من تطبيقك لاستخدامها. لمزيد من المعلومات، راجِع دليل التفويض.