Method: permissions.create

• طلب HTTP
• مَعلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات الأذونات
• جرِّبه الآن

تنشئ هذه الطريقة إذنًا لملف أو مساحة تخزين سحابي مشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على مشاركة الملفات والمجلدات ومساحات التخزين.

تحذير: لا تتوفّر عمليات الأذونات المتزامنة على الملف نفسه، ويتم تطبيق آخر تعديل فقط.

طلب HTTP

POST https://www.googleapis.com/drive/v3/files/{fileId}/permissions

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات المسار

المعلمات
fileId	string معرّف الملف أو مساحة التخزين السحابي المشتركة

مَعلمات طلب البحث

المعلمات
emailMessage	string رسالة مخصّصة بنص عادي لتضمينها في الإشعار عبر البريد الإلكتروني
enforceSingleParent (deprecated)	boolean تم إيقافها نهائيًا: يُرجى الاطّلاع على moveToNewOwnersRoot لمعرفة التفاصيل.
moveToNewOwnersRoot	boolean لا تسري هذه المَعلمة إلا إذا لم يكن العنصر في مساحة تخزين سحابي مشتركة وكان الطلب يحاول نقل ملكية العنصر. إذا تم ضبطها على true، يتم نقل العنصر إلى المجلد الجذر في "ملفاتي" للمالك الجديد وإزالة جميع المجلدات الرئيسية السابقة. إذا تم ضبطها على false، لن يتم تغيير الوالدَين.
sendNotificationEmail	boolean تحديد ما إذا كان سيتم إرسال رسالة إلكترونية تتضمّن إشعارًا عند المشاركة مع مستخدمين أو مجموعات يتم ضبط هذا الخيار تلقائيًا على true للمستخدمين والمجموعات، ولا يُسمح به للطلبات الأخرى. يجب ألا يكون غير مفعّل لعمليات نقل الملكية.
supportsAllDrives	boolean تحديد ما إذا كان التطبيق الذي يطلب الوصول يتيح استخدام كل من "ملفاتي" ومساحات التخزين السحابي المشتركة
supportsTeamDrives (deprecated)	boolean تم إيقاف هذه السياسة نهائيًا، لذا يُرجى استخدام سياسة supportsAllDrives بدلاً منها.
transferOwnership	boolean تحديد ما إذا كان سيتم نقل الملكية إلى المستخدم المحدّد وخفض مرتبة المالك الحالي إلى كاتب هذه المَعلمة مطلوبة كإقرار بالتأثير الجانبي. لمزيد من المعلومات، يُرجى الاطّلاع على نقل ملكية الملف.
useDomainAdminAccess	boolean أرسِل الطلب بصفتك مشرف نطاق. إذا تم ضبطها على true، وفي حال استيفاء الشروط الإضافية التالية، يتم منح طالب الوصول الإذن: تشير مَعلمة رقم تعريف الملف إلى مساحة تخزين سحابي مشتركة. مقدّم الطلب هو مشرف النطاق الذي تنتمي إليه مساحة التخزين السحابي المشتركة. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة مساحات التخزين السحابي المشتركة بصفتك مشرف نطاق.
enforceExpansiveAccess	boolean تحديد ما إذا كان الطلب يجب أن يفرض قواعد وصول شاملة.

نص الطلب

يحتوي نص الطلب على مثال Permission.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال تم إنشاؤه حديثًا Permission.

نطاقات الأذونات

يجب توفير أحد نطاقات OAuth التالية:

• https://www.googleapis.com/auth/drive
• https://www.googleapis.com/auth/drive.file

بعض النطاقات محظورة وتتطلّب إجراء تقييم أمان لتتمكّن من استخدامها في تطبيقك. لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.