لإنشاء إذن لملف أو مساحة تخزين سحابي مشتركة
تحذير: لا تتوفّر عمليات الأذونات المتزامنة على الملف نفسه، ويتم تطبيق التعديل الأخير فقط.
طلب HTTP
POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions
يستخدم عنوان URL بنية gRPC Transcode.
معلّمات المسار
المعلّمات | |
---|---|
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
بعض النطاقات مقيَّدة وتتطلَّب تقييم أمان لكي يستخدمها تطبيقك. لمزيد من المعلومات، اطّلِع على دليل التفويض.