إدارة اقتراحات الوصول المعلّقة

اقتراح الوصول هو اقتراح من مقدِّم الطلب إلى المُوافِق لمنح المستلِم إذن الوصول إلى عنصر في Google Drive.

يمكن للمُوافِق مراجعة جميع اقتراحات الوصول التي لم يتم حلّها في ملفات Drive واتخاذ إجراء بشأنها. ويعني هذا أنّه يمكنك تسريع عملية الموافقة من خلال طلب اقتراحات الوصول آليًا ثم حلّها. ويسمح أيضًا للمُوافِق بعرض الاقتراحات بشكل مجمّع.

توفر Google Drive API المصدر accessproposals حتى تتمكن من عرض اقتراحات الوصول المعلقة وحلها. تعمل طرق مصدر accessproposals على الملفات والمجلدات والملفات داخل مساحة تخزين سحابي مشتركة، ولكن لا تعمل على مساحة التخزين السحابي المشتركة.

في ما يلي المصطلحات الخاصة باقتراحات الوصول:

  • مقدِّم الطلب: هو المستخدم الذي يبدأ اقتراح الوصول إلى عنصر في Drive.
  • المستلِم: هو المستخدم الذي يتلقّى الأذونات الإضافية على ملف في حال الموافقة على اقتراح الوصول. في كثير من الأحيان، يكون المستلِم هو نفسه مقدِّم الطلب، ولكن ليس دائمًا.
  • المُوافِق: هو المستخدم المسؤول عن الموافقة على اقتراح الوصول (أو رفضه) . ويحدث ذلك عادةً لأنّه مالك المستند أو لديه إمكانية مشاركته.

استخدام مَعلمة fields

إذا أردت تحديد الحقول المطلوب عرضها في الاستجابة، يمكنك ضبط الـ fields مَعلمة النظام مع أي طريقة من طرق مصدر accessproposals. إذا لم تحدّد مَعلمة fields، يعرض الخادم مجموعة تلقائية من الحقول الخاصة بالطريقة. لعرض حقول مختلفة، يُرجى الاطّلاع على مقالة عرض حقول معيّنة.

الحصول على اقتراح وصول معلّق

للحصول على اقتراح وصول، استخدِم طريقة get في مصدر accessproposals مع مَعلمتَي المسار fileId وproposalId. إذا لم يكُن لديك معرّف الاقتراح، يمكنك عرض اقتراحات الوصول المعلّقة باستخدام طريقة list.

عرض اقتراحات الوصول المعلّقة

لعرض جميع اقتراحات الوصول المعلّقة على عنصر في Drive، استدعِ الـ list method على الـ accessproposals resource وضِّمن الـ fileId path parameter.

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