إدارة الموافقات

يوضّح هذا المستند كيفية إدارة الموافقات في Google Drive API.

يمكنك العثور على الموافقات على المحتوى في Google Drive. توفّر Google Drive API المورد approvals حتى تتمكّن من الحصول على حالة موافقاتك وعرضها في قائمة. تعمل طرق المورد approvals على العناصر في Drive و"مستندات Google" وأدوات التحرير الأخرى في Google Workspace.

يمكنك استخدام هذه العملية لتحديد موقع الموافقات في حالات المراجعة الرسمية، مثل مراجعة عقد أو مستند رسمي قبل نشره. تتتبّع الموافقة حالة المراجعة (مثل "قيد التقدّم" أو "موافَق عليها" أو "مرفوضة") والمراجعين المعنيين. تُعدّ الموافقات طريقة ممتازة للتحقّق من صحة المحتوى والاحتفاظ بسجلّ للمراجعين.

للاطّلاع على الموافقات على ملف، يجب أن يكون لديك إذن بقراءة البيانات الوصفية للملف. لمزيد من المعلومات، يُرجى الاطّلاع على الأدوار والأذونات.

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

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

الحصول على موافقة

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

يحتوي نص الاستجابة على مثال لمورد approvals.

قائمة الموافقات

لعرض قائمة بالموافقات على ملف، استدعِ الدالة list في المورد approvals وأدرِج مَعلمة المسار fileId.

يتألف نص الردّ من قائمة بالموافقات على الملف. يتضمّن الحقل items معلومات حول كل موافقة في شكل مرجع approvals.

يتضمّن المرجع approvals أيضًا الكائن Status الذي يقدّم تفاصيل عن حالة الموافقة، بالإضافة إلى الكائن ReviewerResponse الذي يقدّم تفاصيل عن الردّ على موافقة قدّمها مراجع محدّد. يتم تمثيل ردّ المراجع هذا باستخدام العنصر Response.

يمكنك أيضًا تمرير مَعلمات طلب البحث التالية لتخصيص تقسيم الصفحات أو فلترة الموافقات:

  • pageSize: الحد الأقصى لعدد الموافقات التي سيتم عرضها في كل صفحة. في حال عدم ضبط pageSize، يعرض الخادم ما يصل إلى 100 موافقة.

  • pageToken: رمز مميز للصفحة تم تلقّيه من طلب قائمة سابق. يُستخدم هذا الرمز المميز لاسترداد الصفحة التالية. يجب ضبطها على قيمة nextPageToken من استجابة سابقة.