اقتراح الوصول هو اقتراح يقدّمه طالب إلى موافِق لمنح مستلِم إذن الوصول إلى عنصر في Google Drive.
يمكن للموافق مراجعة جميع اقتراحات الوصول التي لم يتم حلّها واتّخاذ إجراء بشأنها في ملفات Drive. وهذا يعني أنّه يمكنك تسريع عملية الموافقة من خلال طلب اقتراحات الوصول بشكل آلي ثم حلّها. ويتيح أيضًا للمستخدم المانح للموافقة الاطّلاع على المقترحات بشكل مجمّع.
توفّر Google Drive API المورد
accessproposals حتى تتمكّن من عرض
مقترحات الوصول المعلّقة وحلّها. تعمل طرق accessproposals
الموارد على الملفات والمجلدات والملفات داخل مساحة التخزين السحابي المشتركة، ولكنها لا تعمل على
مساحة التخزين السحابي المشتركة.
تنطبق المصطلحات التالية على اقتراحات الوصول:
- مقدّم الطلب: هو المستخدم الذي يبدأ اقتراح الوصول إلى ملف أو مجلد في Drive.
- المستلِم: هو المستخدم الذي سيحصل على الأذونات الإضافية في ملف معيّن في حال الموافقة على اقتراح الوصول. في كثير من الأحيان، يكون المستلم هو نفسه مقدّم الطلب، ولكن ليس دائمًا.
- الموافِق: هو المستخدم المسؤول عن الموافقة على اقتراح منح الإذن بالوصول (أو رفضه). ويحدث ذلك عادةً لأنّ المستخدم مالك المستند أو لديه إذن بمشاركته.
استخدام مَعلمة fields
إذا أردت تحديد الحقول المطلوب عرضها في الاستجابة، يمكنك ضبط المَعلمة fields system مع أي طريقة من طرق المورد accessproposals. في حال حذف المَعلمة fields
، يعرض الخادم مجموعة تلقائية من الحقول الخاصة بالطريقة. لعرض حقول مختلفة، راجِع عرض حقول معيّنة.
الحصول على اقتراح وصول في انتظار المراجعة
للحصول على اقتراح بشأن إذن الوصول، استخدِم طريقة get في مورد accessproposals مع مَعلمتَي المسار fileId وproposalId. إذا كنت لا تعرف معرّف الاقتراح، يمكنك إدراج اقتراحات الوصول المعلقة باستخدام طريقة list.
عرض قائمة باقتراحات الوصول المعلّقة
لعرض جميع طلبات الوصول المعلقة إلى ملف في Drive، استدعِ طريقة
list في مورد
accessproposals وأدرِج مَعلمة المسار
fileId.
يمكن للموافقين على ملف فقط إدراج الاقتراحات المعلّقة في ملف. الموافق هو مستخدم لديه إذن can_approve_access_proposals على الملف. إذا لم يكن مقدّم الطلب من الموافقين، سيتم عرض قائمة فارغة. لمزيد من المعلومات حول capabilities، يُرجى الاطّلاع على التعرّف على إمكانات الملف.
يتألف نص الاستجابة من الكائن accessproposals الذي يمثّل قائمة بمقترحات الوصول التي لم يتم حلّها في الملف.
يتضمّن العنصر accessproposals معلومات حول كل اقتراح، مثل مقدّم الطلب والمستلِم والرسالة التي أضافها مقدّم الطلب. ويتضمّن أيضًا كائن RoleAndView يجمع بين role المقترَحة من مقدّم الطلب وview. بما أنّ role
هو حقل متكرّر، يمكن أن تتوفّر مضاعفات لكلّ اقتراح. على سبيل المثال، قد يتضمّن الاقتراح عنصر RoleAndView من النوع role=reader وview=published، بالإضافة إلى عنصر RoleAndView آخر يتضمّن القيمة role=writer فقط. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة المشاهدات.
مرِّر مَعلمات طلب البحث التالية لتخصيص تقسيم الصفحات أو فلترة اقتراحات الوصول:
pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. قدِّم الرمز المميز هذا لاسترداد الصفحة التالية.pageSize: الحدّ الأقصى لعدد اقتراحات الوصول التي سيتم عرضها في كل صفحة
الاستجابة إلى اقتراحات الوصول المعلّقة
لحلّ جميع اقتراحات الوصول المعلقة إلى عنصر في Drive، استدعِ طريقة resolve في المرجع accessproposals وأدرِج مَعلمتَي المسار fileId وproposalId.
تتضمّن الطريقة resolve مَعلمة طلب بحث action تشير إلى الإجراء الذي يجب اتّخاذه بشأن الاقتراح. يتتبّع العنصر
Action تغيير الحالة في الاقتراح لنعرف ما إذا كان سيتم قبوله أو رفضه.
تتضمّن الطريقة resolve أيضًا مَعلمتَي طلب البحث الاختياريتَين role وview. الأدوار المتوافقة فقط هي writer وcommenter وreader. إذا لم يتم تحديد الدور، سيتم تلقائيًا ضبطه على reader. لمزيد من المعلومات، يُرجى الاطّلاع على الأدوار والأذونات. يتيح لك مَعلمة طلب اختيارية إضافية sendNotification إرسال إشعار عبر البريد الإلكتروني إلى مقدّم الطلب عند قبول الاقتراح أو رفضه.
كما هو الحال مع الطريقة list، يجب أن يكون لدى المستخدمين الذين يحلّون الاقتراح إذن can_approve_access_proposals على الملف. لمزيد من المعلومات حول capabilities، يُرجى الاطّلاع على التعرّف على إمكانات الملف.
يتم حلّ الاقتراحات باستخدام الأنماط نفسها المدرَجة ضمن سيناريوهات لمشاركة موارد Drive. في حال توفُّر عدة اقتراحات للمستخدم نفسه ولكن بأدوار مختلفة، ينطبق ما يلي:
- إذا تم قبول أحد الاقتراحين ورفض الآخر، سيتم تطبيق الدور المقبول على ملف Drive.
- في حال قبول كلا الاقتراحين في الوقت نفسه، سيتم تطبيق الاقتراح الذي يتضمّن إذنًا أعلى (على سبيل المثال،
role=writerبدلاً منrole=reader). تتم إزالة اقتراح الوصول الآخر من العنصر.
بعد إرسال اقتراح إلى الطريقة resolve، يكتمل إجراء المشاركة. لم يعُد يتم عرض اقتراح الوصول الذي تم حلّه من خلال طريقة list. بعد قبول الاقتراح، على المستخدم استخدام مورد permissions لتعديل الأذونات على ملف أو مجلد. لمزيد من المعلومات، يُرجى الاطّلاع على تعديل الأذونات.