ترتبط كل ملف ومجلد ومساحة تخزين سحابي مشتركة على Google Drive بموارد
permissions
. يحدِّد كل مورد
الإذن لملف type
(user
أو group
أو domain
أو
anyone
) وrole
(owner
أو organizer
أو fileOrganizer
أو writer
أو
commenter
أو reader
) معيّن. على سبيل المثال، قد يحتوي الملف على إذن يمنح مستخدمًا معيّنًا (type=user
) إذن الوصول للقراءة فقط (role=reader
)، في حين يمنح إذن آخر أعضاء مجموعة معيّنة (type=group
) إمكانية إضافة kommentiert إلى ملف (role=commenter
).
للحصول على قائمة كاملة بالأدوار والعمليات المسموح بها لكل دور، يُرجى الرجوع إلى الأدوار والأذونات.
سيناريوهات لمشاركة مراجع Drive
هناك خمسة أنواع مختلفة من سيناريوهات المشاركة:
لمشاركة ملف في "ملفاتي"، يجب أن يكون لدى المستخدم إذن
role=writer
أوrole=owner
.إذا تم ضبط القيمة المنطقية
writersCanShare
علىfalse
للملف، يجب أن يكون لدى المستخدمrole=owner
.إذا كان لدى المستخدم الذي لديه
role=writer
إذن وصول مؤقت يخضع لتاريخ ووقت انتهاء الصلاحية، لن يتمكن من مشاركة الملف. لمزيد من المعلومات، يُرجى الاطّلاع على تحديد تاريخ انتهاء صلاحية للحد من الوصول إلى الملفات.
لمشاركة مجلد في "ملفاتي"، يجب أن يكون لدى المستخدم إذن
role=writer
أوrole=owner
.وإذا تم ضبط القيمة المنطقية
writersCanShare
علىfalse
للملف، يجب أن يملك المستخدم قيمةrole=owner
الأكثر تساهلاً.لا يُسمح بالوصول المؤقت (الذي يخضع لتاريخ ووقت انتهاء صلاحية) إلى مجلدات "ملفاتي" باستخدام
role=writer
. لمزيد من المعلومات، اطّلِع على تحديد تاريخ انتهاء صلاحية للحد من الوصول إلى الملفات.
لمشاركة ملف في مساحة تخزين سحابي مشتركة، يجب أن يكون لدى المستخدم إذن الوصول
role=writer
أوrole=fileOrganizer
أوrole=organizer
.- لا ينطبق الإعداد
writersCanShare
على العناصر في مساحات التخزين السحابي المشتركة. ويتم التعامل معه كما لو كان مضبوطًا دائمًا علىtrue
.
- لا ينطبق الإعداد
لمشاركة مجلد في مساحة تخزين سحابي مشتركة، يجب أن يكون لدى المستخدم
role=organizer
.- في حال ضبط التقييد
sharingFoldersRequiresOrganizerPermission
على مساحة تخزين سحابي مشتركة علىfalse
، يمكن للمستخدمين الذين لديهمrole=fileOrganizer
مشاركة المجلدات في مساحة التخزين السحابي المشتركة هذه.
- في حال ضبط التقييد
لإدارة العضوية في مساحة التخزين السحابي المشتركة، يجب أن يكون لدى المستخدم
role=organizer
. يمكن فقط للمستخدمين والمجموعات أن يكونوا أعضاء في مساحات التخزين السحابي المشتركة.
ضبط تاريخ انتهاء صلاحية لتقييد الوصول إلى الملفات
عند العمل مع مستخدمين في مشروع حسّاس، قد تريد تقييد وصولهم إلى ملفات معيّنة في Drive بعد فترة زمنية. بالنسبة إلى الملفات في "ملفاتي"، يمكنك تحديد تاريخ انتهاء صلاحية لتحديد الحد الأقصى لعدد المستخدمين الذين يمكنهم الوصول إلى هذا الملف أو إزالتهم.
لتحديد تاريخ انتهاء الصلاحية:
استخدِم طريقة
create()
على الموردpermissions
واضبط الحقلexpirationTime
(بالإضافة إلى الحقول المطلوبة الأخرى). لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء إذن.استخدِم طريقة
update()
على موردpermissions
واضبط الحقلexpirationTime
(بالإضافة إلى الحقول الأخرى المطلوبة). لمزيد من المعلومات، يُرجى الاطّلاع على تغيير الأذونات.
يشير الحقل expirationTime
إلى وقت انتهاء صلاحية الإذن باستخدام RFC 3339
date-time. تنطبق القيود التالية على مُدد انتهاء الصلاحية:
- ولا يمكن ضبطها إلا على أذونات المستخدمين والمجموعات.
- يجب أن يكون الوقت في المستقبل.
- لا يمكن أن يكون الوقت في المستقبل أكثر من سنة.
لمزيد من المعلومات عن تاريخ انتهاء الصلاحية، اطّلِع على المقالات التالية:
نشر الأذونات
تنتشر قوائم الأذونات للمجلد نزولاً، وتكتسب جميع الملفات والمجلدات الفرعية الأذونات من المجلد الرئيسي. عند تغيير الأذونات أو التسلسل الهرمي، يحدث النشر بشكل متكرر في جميع المجلدات المضمّنة. على سبيل المثال، في حال توفّر ملف في مجلد ونقل هذا المجلد إلى مجلد آخر، يتم نشر الأذونات في المجلد الجديد إلى الملف. إذا منح المجلد الجديد مستخدم الملف دورًا جديدًا، مثل "كاتب"، سيتم إلغاء دوره القديم.
في المقابل، إذا اكتسب ملف الدور role=writer
من مجلد، وتم نقله إلى
مجلد آخر يقدّم دور "قارئ"، يكتسب الملف الآن الدور
role=reader
.
لا يمكن إزالة الأذونات المكتسَبة من ملف أو مجلد في مساحة تخزين سحابي مشتركة. بدلاً من ذلك، يجب تعديل هذه الأذونات في الحساب الرئيسي المباشر أو غير المباشر الذي اكتسبت منه هذه الأذونات. يمكن إزالة الأذونات المكتسَبة من العناصر ضمن "ملفاتي" أو "تمت مشاركتها معي".
في المقابل، يمكن إلغاء الأذونات المكتسَبة في ملف أو مجلد في "ملفاتي" على Drive. وبالتالي، إذا اكتسب ملف الإذن role=writer
من مجلد "ملفاتي" في Drive، يمكنك ضبط role=reader
على الملف لخفض مستوى
الإذن.
الإمكانات
لا يحدّد مرجع permissions
في نهاية المطاف قدرة المستخدم الحالي على تنفيذ إجراءات على ملف أو
مجلد. بدلاً من ذلك، يحتوي المورد files
على
مجموعة من حقول capabilities
المنطقية المستخدمة للإشارة إلى ما إذا كان يمكن
تنفيذ إجراء على ملف أو مجلد. تضبط Google Drive API هذه الحقول استنادًا
إلى مرجع أذونات المستخدم الحالي المرتبط بالملف أو المجلد.
على سبيل المثال، عندما يسجّل أليكس الدخول إلى تطبيقك ويحاول مشاركة ملف، يتم التحقق من دور أليكس
ولمعرفة ما إذا كان لديه أذونات في الملف. إذا كان الدور يسمح له بمشاركة ملف، يتم ملء capabilities
المرتبط بالملف، مثل canShare
،
بالنسبة إلى الدور. إذا أراد "علي" مشاركة الملف، يتحقّق تطبيقك من
capabilities
للتأكّد من ضبط canShare
على true
.
للحصول على مثال على استرداد الملف capabilities
، اطّلِع على التحقّق من أذونات
المستخدم.
إنشاء إذن
يجب ملء الحقلين التاليين عند إنشاء إذن:
type
: يحدِّد الرمزtype
نطاق الإذن (user
أوgroup
أوdomain
أوanyone
). وينطبق الإذن الذي يتضمّنtype=user
على مستخدم معيّن، في حين ينطبق الإذن الذي يتضمّنtype=domain
على جميع المستخدمين في نطاق معيّن.role
: يحدِّد حقلrole
العمليات التي يمكن أن ينفّذهاtype
. على سبيل المثال، يمنح الإذن الذي يتضمّنtype=user
وrole=reader
مستخدمًا معيّنًا إذن وصول للقراءة فقط إلى الملف أو المجلد. أو يسمح الإذن الذي يتضمّنtype=domain
وrole=commenter
لجميع المستخدمين في النطاق بإضافة تعليقات إلى ملف. للاطّلاع على قائمة كاملة بالأدوار والعمليات التي يسمح بها كل منها، يُرجى الرجوع إلى الأدوار والأذونات.
عند إنشاء إذن يتضمّن type=user
أو type=group
، يجب أيضًا
تقديم emailAddress
لربط
مستخدم أو مجموعة معيّنين بالإذن.
عند إنشاء إذن حيث يكون type=domain
، يجب أيضًا تقديم
domain
لربط نطاق معيّن بال
الإذن.
لإنشاء إذن:
- استخدِم الطريقة
create()
مع مَعلمة المسارfileId
للملف أو المجلد المرتبط. - في نص الطلب، حدِّد
type
وrole
. - إذا كان الخيار
type=user
أوtype=group
، أدخِلemailAddress
. إذا كانtype=domain
، قدِّمdomain
.
عرض مثال
يوضّح نموذج الرمز البرمجي التالي كيفية إنشاء إذن. تعرِض الاستجابة مثيلًا لمصدر Permission
، بما في ذلك permissionId
المحدَّد.
طلب
POST https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions
{ "requests": [ { "type": "user", "role": "commenter", "emailAddress": "alex@altostrat.com" } ] }
الردّ
{
"kind": "drive#permission",
"id": "PERMISSION_ID
",
"type": "user",
"role": "commenter"
}
استخدام شرائح الجمهور المستهدَفة
الجماهير المستهدفة هي مجموعات من الأشخاص، مثل الأقسام أو الفِرق، يمكنك اقتراحها للمستخدمين لمشاركة العناصر معهم. يمكنك تشجيع المستخدمين على مشاركة العناصر مع جمهور أكثر تحديدًا أو محدودًا بدلاً من مشاركة المؤسسة بأكملها. يمكن أن تساعدك الجماهير المستهدَفة في تحسين أمان بياناتك وخصوصيتها، وتسهيل مشاركة المستخدمين لها بشكل مناسب. لمزيد من المعلومات، اطّلِع على لمحة عن شرائح الجماهير المستهدفة .
لاستخدام شرائح الجمهور المستهدَفة:
في "وحدة تحكّم المشرف في Google"، انتقِل إلى رمز القائمة > الدليل > الجماهير المستهدَفة.
الانتقال إلى "الجماهير المستهدفة"
يجب تسجيل الدخول باستخدام حساب يمتلك امتيازات المشرف المتميّز لتنفيذ هذه المهمة.
في قائمة الجماهير المستهدَفة، انقر على اسم الجمهور المستهدَف. لإنشاء جمهور مستهدف، اطّلِع على مقالة إنشاء جمهور مستهدف.
انسخ المعرّف الفريد من عنوان URL للجمهور المستهدَف:
https://admin.google.com/ac/targetaudiences/ID
.أنشئ إذنًا باستخدام
type=domain
، واضبط الحقلdomain
علىID.audience.googledomains.com
.
للاطّلاع على كيفية تفاعل المستخدِمين مع شرائح الجمهور المستهدَفة، اطّلِع على تجربة المستخدِم للمشاركة باستخدام رابط .
استرداد جميع الأذونات لملف أو مجلد أو مساحة تخزين سحابي مشتركة
استخدِم طريقة list()
في مورد
permissions
لاسترداد
جميع الأذونات لملف أو مجلد أو مساحة تخزين سحابي مشترَكة.
عرض مثال
يوضّح نموذج الرمز البرمجي التالي كيفية الحصول على جميع الأذونات. يعرض الردّ قائمة بالأذونات.
الطلب
GET https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions
الاستجابة
{
"kind": "drive#permissionList",
"permissions": [
{
"id": "PERMISSION_ID
",
"type": "user",
"kind": "drive#permission",
"role": "commenter"
}
]
}
التحقّق من أذونات المستخدم
عندما يفتح تطبيقك ملفًا، من المفترض أن يتحقّق من إمكانات الملف وأن يعرض واجهة المستخدم لتعكس أذونات المستخدم الحالي. على سبيل المثال، إذا لم يكن لدى المستخدم
إذن canComment
على الملف، يجب إيقاف إمكانية التعليق
في واجهة المستخدم.
لمزيد من المعلومات عن capabilities
، اطّلِع على قسم الإمكانات
.
للتحقّق من الإمكانات، يمكنك استدعاء طريقة get()
في مورد files
باستخدام مَعلمة fileId
المسار ومَعلمة fields
التي تم ضبطها على الحقل capabilities
. للمزيد من المعلومات حول عرض الحقول باستخدام المَعلمة fields
، يُرجى الاطّلاع على عرض حقول محدّدة لملف.
عرض مثال
يوضّح نموذج الرمز البرمجي التالي كيفية التحقّق من أذونات المستخدم. يعرض الردّ قائمة بالصلاحيات التي يمتلكها المستخدم في الملف. تتوافق كل قدرة مع إجراء دقيق يمكن للمستخدم اتّخاذه. لا يتم ملء بعض الحقول إلا للعناصر في مساحات التخزين السحابي المشتركة.
الطلب
GET https://www.googleapis.com/drive/v3/files/FILE_ID
?fields=capabilities
الردّ
{ "capabilities": { "canAcceptOwnership": false, "canAddChildren": false, "canAddMyDriveParent": false, "canChangeCopyRequiresWriterPermission": true, "canChangeSecurityUpdateEnabled": false, "canComment": true, "canCopy": true, "canDelete": true, "canDownload": true, "canEdit": true, "canListChildren": false, "canModifyContent": true, "canModifyContentRestriction": true, "canModifyLabels": true, "canMoveChildrenWithinDrive": false, "canMoveItemOutOfDrive": true, "canMoveItemWithinDrive": true, "canReadLabels": true, "canReadRevisions": true, "canRemoveChildren": false, "canRemoveMyDriveParent": true, "canRename": true, "canShare": true, "canTrash": true, "canUntrash": true } }
تحديد مصدر الأدوار لملفات مساحة التخزين السحابي المشتركة والمجلدات فيها
لتغيير الدور على ملف أو مجلد، عليك معرفة مصدر الدور. بالنسبة إلى مساحات التخزين السحابي المشتركة، يمكن أن يستند مصدر الدور إلى العضوية في مساحة التخزين السحابي المشتركة أو الدور في مجلد أو الدور في ملف.
لتحديد مصدر الدور لمساحة التخزين السحابي المشتركة أو العناصر ضمن مساحة التخزين السحابي هذه، يمكنك استدعاء طريقة get()
في المورد permissions
باستخدام مَعلمتَي المسار fileId
وpermissionId
وضبط المَعلمة fields
على الحقل permissionDetails
.
للعثور على permissionId
، استخدِم الإجراء
list()
على المَعلمةpermissions
مع مَعلمة المسارfileId
. لجلب حقل permissionDetails
في طلب list
، اضبط المَعلمة fields
على
permissions/permissionDetails
.
يسرد هذا الحقل جميع أذونات الملفات المكتسَبة والمُباشرة للمستخدم أو المجموعة أو النطاق.
عرض مثال
يوضّح نموذج الرمز البرمجي التالي كيفية تحديد مصدر الدور. يعرض الردّ permissionDetails
لمصدر permissions
. يقدّم الحقل inheritedFrom
معرّف العنصر الذي يتم اكتساب الإذن منه.
طلب
GET https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
?fields=permissionDetails&supportsAllDrives=true
الردّ
{
"permissionDetails": [
{
"permissionType": "member",
"role": "commenter",
"inheritedFrom": "INHERITED_FROM_ID
",
"inherited": true
},
{
"permissionType": "file",
"role": "writer",
"inherited": false
}
]
}
تغيير الأذونات
لتغيير الأذونات في ملف أو مجلد، يمكنك تغيير الدور المخصّص:
استخدِم طريقة
update()
في موردpermissions
مع ضبط مَعلمة مسارpermissionId
على إذن التغيير وضبط مَعلمة مسارfileId
على الملف أو المجلد أو مساحة التخزين السحابي المشتركة المرتبطة. للعثور علىpermissionId
، استخدِم الإجراءlist()
على المَعلمةpermissions
مع مَعلمة المسارfileId
.في الطلب، حدِّد
role
الجديد.
يمكنك منح أذونات على ملفات أو مجلدات فردية في مساحة تخزين سحابي مشتركة حتى
إذا كان المستخدم أو المجموعة عضوًا فيها. على سبيل المثال، لدى "علي" role=commenter
كجزء من عضويته في مساحة تخزين سحابي مشتركة. ومع ذلك، يمكن لتطبيقك منح "أليكس"
role=writer
إذن الوصول إلى ملف في مساحة تخزين سحابي مشتركة. في هذه الحالة، بما أنّ الدور الجديد
أكثر تساهلاً من الدور الممنوح من خلال العضوية، يصبح الإذن
الجديد هو الدور الفعال للملف أو المجلد.
عرض مثال
يعرض نموذج الرمز البرمجي التالي كيفية تغيير الأذونات على ملف أو مجلد من معلِّق إلى كاتب. تعرِض الاستجابة مثيلًا لمصدر permissions
.
الطلب
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
{ "requests": [ { "role": "writer" } ] }
الاستجابة
{
"kind": "drive#permission",
"id": "PERMISSION_ID
",
"type": "user",
"role": "writer"
}
إدراج اقتراحات الوصول في انتظار المراجعة وحلّها
اقتراح الوصول هو اقتراح يقدّمه مقدّم الطلب إلى جهة الموافقة لمنح مستلِم الإذن بالوصول إلى عنصر في Drive.
يمكن لجهة الموافقة مراجعة جميع اقتراحات الوصول التي لم يتم حلّها فيملفّات Drive واتّخاذ إجراء بشأنها. وهذا يعني أنّه يمكنك تسريع عملية الموافقة من خلال إجراء طلب بحث آلي عن اقتراحات الوصول ثم حلّها. ويسمح أيضًا للموافق بالاطّلاع على الاقتراحات بشكل مجمّع.
توفّر واجهة برمجة تطبيقات Drive المورد
accessproposals
لكي تتمكّن من عرض اقتراحات الوصول المعلّقة وحلّها. تعمل طُرق ملف موارد
accessproposals
على الملفات والمجلدات والملفات ضمن ملف
تخزين سحابي مشترَك، ولكن ليس على مساحة التخزين السحابي المشتركة.
تنطبق المصطلحات التالية على طلبات الوصول:
- المُقدّم: المستخدم الذي يقدّم اقتراح الوصول إلى ملف في Drive
- المستلِم: المستخدم الذي يتلقّى الأذونات الإضافية على ملف في حال منح اقتراح الوصول في كثير من الأحيان، يكون المستلِم هو نفسه العميل الذي подал الطلب، ولكن ليس دائمًا.
- المنِح للموافقة: المستخدم المسؤول عن الموافقة (أو الرفض) على اقتراح الوصول ويعود ذلك عادةً إلى أنّه مالك للمستند أو لديه إمكانية مشاركته.
عرض طلبات الوصول المعلّقة
لعرض جميع طلبات الوصول المعلّقة في عنصر على Drive، استخدِم الأسلوب
list()
في
المورد accessproposals
وأدرِج مَعلمة المسار fileId
.
يمكن للموافقين فقط في ملف إدراج الاقتراحات المعلّقة في ملف. المستخدم المانِح للموافقة هو مستخدم لديه إمكانية can_approve_access_proposals
في الملف. إذا لم يكن مقدِّم الطلب مستخدمًا مانِحًا للموافقة، سيتم عرض قائمة فارغة. لمزيد من المعلومات
عن capabilities
، اطّلِع على قسم الإمكانات.
يتألّف جسم
الاستجابة
من عنصر
AccessProposal
يمثّل قائمة باقتراحات الوصول غير المحسّنة في الملف.
يتضمّن عنصر AccessProposal
معلومات عن كل اقتراح، مثل
المُقدّم والمستقبل والرسالة التي أضافها المُقدّم. ويتضمّن أيضًا
عنصر AccessProposalRoleAndView
يجمع role
المقترَح لمقدّم الطلب مع view
. بما أنّ role
حقل متكرّر، يمكن أن تتوفّر قيم متعدّدة لكلّ اقتراح. على سبيل المثال، قد يحتوي
الاقتراح على عنصر AccessProposalRoleAndView
من role=reader
و
view=published
، بالإضافة إلى عنصر AccessProposalRoleAndView
إضافي يحتوي على
قيمة role=writer
فقط. لمزيد من المعلومات، يُرجى الاطّلاع على الملفات الشخصية.
نقْل مَعلمات طلب البحث التالية لتخصيص تقسيم الصفحات لاقتراحات الوصول أو فلترتها:
pageToken
: رمز مميّز للصفحة، تم تلقّيه من طلب قائمة سابق قدِّم هذا الرمز المميّز لاسترداد الصفحة اللاحقة.pageSize
: الحد الأقصى لعدد اقتراحات الوصول التي سيتم عرضها في كل صفحة
حلّ اقتراحات الوصول في انتظار المراجعة
لحلّ جميع اقتراحات الوصول المعلّقة في أحد
عناصر Drive، يمكنك استدعاء الأسلوب
resolve()
في المورد accessproposals
وتضمين مَعلمتَي مسارfileId
وproposalId
.
تتضمّن الطريقة resolve()
مَعلمة طلب بحث action
تشير إلى
الإجراء الذي يجب اتّخاذه بشأن الاقتراح. يتتبّع العنصر
Action
تغيير حالة الاقتراح لنعرف ما إذا كان سيتم قبوله
أو رفضه.
تتضمّن طريقة resolve()
أيضًا مَعلمات طلب البحث الاختيارية role
و
view
. الأدوار الوحيدة المتوافقة هي writer
وcommenter
وreader
. إذا لم يتم تحديد الدور، سيتم ضبطه تلقائيًا على "reader
". تتيح لك مَعلمة طلب بحث اختيارية إضافية send_notification
إرسال إشعار عبر البريد الإلكتروني إلى العميل عند قبول الاقتراح أو رفضه.
كما هو الحال مع طريقة list()
، يجب أن تتوفّر للمستخدمين الذين يجرون الاقتراح، ميزة can_approve_access_proposals
في الملف. لمزيد من المعلومات
عن capabilities
، اطّلِع على قسم الإمكانات.
يتم حلّ الاقتراحات باستخدام الأنماط نفسها المدرَجة ضمن سيناريوهات مشاركة موارد Drive. إذا كانت هناك اقتراحات متعدّدة للمستخدِم نفسه، ولكن بأدوار مختلفة، ينطبق ما يلي:
- إذا تم قبول اقتراح ورفض اقتراح آخر، ينطبق الدور المقبول على عنصر Drive.
- في حال قبول العرضَين في الوقت نفسه، يتم تطبيق الاقتراح
الحاصل على إذن أعلى (على سبيل المثال،
role=writer
مقابلrole=reader
). ستتم إزالة اقتراح الوصول الآخر من العنصر.
بعد إرسال اقتراح إلى طريقة resolve()
، يكتمل إجراء المشاركة. لم يعُد يتم عرض AccessProposal
من خلال الطريقة list()
. بعد قبول الاقتراح، على المستخدم استخدام مجموعة
permissions
لتعديل
الأذونات في ملف أو مجلد. لمزيد من المعلومات، يُرجى الاطّلاع على القسم تغيير
الأذونات.
إلغاء إذن الوصول إلى ملف أو مجلد
لإلغاء إذن الوصول إلى ملف أو مجلد، يمكنك استدعاء الأسلوب
delete()
في مورد
permissions
مع ضبط مَعلمات مسار
fileId
وpermissionId
لحذف الإذن.
بالنسبة إلى العناصر في "ملفاتي"، من الممكن حذف إذن حاصل عليه من مصدر آخر. يؤدي حذف إذن موروث إلى إلغاء إمكانية الوصول إلى العنصر والعناصر الفرعية، إن توفّرت.
بالنسبة إلى العناصر في مساحة تخزين سحابي مشتركة، لا يمكن إلغاء الأذونات المكتسَبة. قم بتحديث الإذن أو إبطاله على الملف أو المجلد الرئيسي بدلاً من ذلك.
يتم استخدام الطريقة delete()
أيضًا لحذف الأذونات التي يتم تطبيقها مباشرةً على ملف أو مجلد مساحة تخزين سحابي مشتركة.
عرض مثال
يوضّح نموذج الرمز البرمجي التالي كيفية إبطال إذن الوصول عن طريق حذف permissionId
. إذا كانت الاستجابة ناجحة، يكون نص الاستجابة فارغًا. لتأكيد إزالة الإذن، استخدِم الطريقة list()
في مورد permissions
مع مَعلمة المسار fileId
.
طلب
DELETE https://www.googleapis.com/drive/v3/files/FILE_ID
/permissions/PERMISSION_ID
نقل ملكية الملف إلى حساب آخر على Google Workspace في المؤسسة نفسها
يمكن نقل ملكية الملفات الحالية في "ملفاتي" من حساب Google Workspace إلى حساب آخر في المؤسسة نفسها. تمتلك المؤسسة التي تمتلك مساحة درايفية مشتركة الملفات داخلها. لذلك، لا تتوفر إمكانية نقل الملكية للملفات والمجلدات في مساحات التخزين السحابي المشتركة. يمكن لمنظمي مساحة التخزين السحابي المشتركة نقل العناصر من مساحة التخزين السحابي المشتركة هذه إلى "ملفاتي" الخاصة بهم، ما يؤدي بدوره إلى نقل الملكية إليهم.
لنقل ملكية ملف في "ملفاتي"، نفِّذ أحد الإجراءات التالية:
أنشئ إذن ملف يمنح مستخدمًا معيّنًا (
type=user
) إذن وصول مالك (role=owner
).عدِّل إذن ملف حالي باستخدام
role=owner
وانقل الملكية إلى المستخدم المحدّد (transferOwnership=true
).
نقل ملكية ملف من حساب مستهلك إلى آخر
ويمكن نقل ملكية الملفات بين حساب مستهلك إلى آخر. ومع ذلك، لا ينقل Drive ملكية ملف بين حسابَي مستهلكَين إلى أن يوافق المالك المحتمل على النقل صراحةً. لنقل ملكية ملف من حساب مستهلك إلى حساب آخر:
يبدأ المالك الحالي عملية نقل الملكية من خلال إنشاء أو تعديل إذن الملف الخاص بالمالك المحتمل. يجب أن يتضمّن الإذن الإعدادات التالية:
role=writer
وtype=user
وpendingOwner=true
. إذا كان المالك الحالي ينشئ إذنًا للمالك المحتمل، يتم إرسال إشعار عبر البريد الإلكتروني إلى المالك المحتمل يشير إلى أنّه تتم دعوة المالك المحتمل إلى تولي ملكية الملف.يقبل المالك المحتمل طلب نقل الملكية من خلال إنشاء إذن الملف أو تعديله. يجب أن يتضمّن الإذن الإعدادَين التاليَين:
role=owner
وtransferOwnership=true
. إذا كان المالك المحتمل ينشئ إذنًا جديدًا، يتم إرسال إشعار عبر البريد الإلكتروني إلى المالك السابق للإشارة إلى أنّه تم نقل الملكية.
عند نقل ملف، يتم خفض دور المالك السابق إلى writer
.
تغيير أذونات متعددة باستخدام طلبات مجمّعة
ننصحك بشدة باستخدام طلبات الحِزم لتعديل عدة أذونات.
في ما يلي مثال على إجراء تعديل على أذونات مجمَّعة باستخدام مكتبة عملاء.
Java
Python
Node.js
PHP
NET.
مواضيع ذات صلة
- حماية محتوى الملف
- الوصول إلى ملفات Drive التي تمت مشاركتها باستخدام رابط باستخدام مفاتيح الموارد
- الأدوار والأذونات