REST Resource: matters

المرجع: Matter

يمثل مسألة قانونية.

للعمل باستخدام موارد Vault، يجب أن يكون للحساب امتيازات Vault المطلوبة وإمكانية الوصول إلى المسألة القانونية. للوصول إلى مسألة قانونية، يجب أن يكون الحساب قد أنشأ المسألة القانونية أو شارك المسألة القانونية معه، أو أن يمتلك امتياز عرض جميع المسائل القانونية.

تمثيل JSON 
{
  "matterId": string,
  "name": string,
  "description": string,
  "state": enum (State),
  "matterPermissions": [
    {
      object (MatterPermission)
    }
  ]
  "matter_region": enum (MatterRegion),
}
الحقول
matterId

string

رقم تعريف المسألة القانونية الذي أنشأه الخادم اتركه فارغًا عند إنشاء مسألة قانونية.
name

string

اسم المسألة القانونية
description

string

وصف اختياري للمسألة القانونية.
state

enum (State)

حالة المسألة القانونية.
matterPermissions[]

object (MatterPermission)

يسرد المستخدمين وأذوناتهم للمسألة القانونية. في الوقت الحالي، ليس هناك حدّ أقصى محدَّد من قِبل المبرمج لعدد الأذونات التي يمكن أن تمنحها لمسألة قانونية.
matter_region

enum (MatterRegion)

منطقة البيانات للمسألة القانونية.

الحالة

حالة مسألة قانونية.

عمليات التعداد
STATE_UNSPECIFIED المسألة القانونية ليس لها حالة محددة.
OPEN المسألة القانونية مفتوحة.
CLOSED تم إغلاق المسألة القانونية.
DELETED تم حذف المسألة القانونية.

MatterPermission

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

تمثيل JSON 
{
  "role": enum (AclRole),
  "accountId": string
}
الحقول
role

enum (AclRole)

دور المستخدم في المسألة القانونية
accountId

string

رقم تعريف الحساب، كما تم توفيره من خلال SDK للمشرف.

AclRole

أذونات المستخدم المحتملة لمسألة قانونية، بترتيب زيادة الأذونات.

عمليات التعداد
ROLE_UNSPECIFIED لم يتمّ تخصيص أي دور.
COLLABORATOR متعاون في المسألة
OWNER مالك المسألة القانونية

منطقة Matter

منطقة البيانات لمسألة قانونية.

عمليات التعداد
MATTER_REGION_UNSPECIFIED لا تتضمّن المسألة القانونية منطقة بيانات محدّدة.
ANY لا تتضمّن المسألة القانونية منطقة بيانات محدّدة.
US تشمل المسألة القانونية منطقة بيانات في الولايات المتحدة الأمريكية.
EU للمسألة القانونية منطقة بيانات خاصة بالاتحاد الأوروبي.

الطُرق

addPermissions

 إضافة حساب كمتعاون في المسألة القانونية

close

 يؤدي هذا الإجراء إلى إغلاق المسألة القانونية المحدّدة.

count

 تحتسب الحسابات التي تمت معالجتها من خلال طلب البحث المحدّد.

create

 يتم إنشاء مسألة قانونية بالاسم والوصف المحدّدين.

delete

 يؤدي هذا الإجراء إلى حذف المسألة القانونية المحدّدة.

get

 للحصول على المسألة القانونية المحدّدة.

list

 يتم إدراج المسائل القانونية التي يمكن لمقدِّم الطلب الوصول إليها.

removePermissions

 إزالة حساب كمتعاون في المسألة القانونية

reopen

 يعيد فتح المسألة القانونية المحدّدة.

undelete

 يؤدي هذا الإجراء إلى إلغاء حذف المسألة القانونية المحدّدة.

update

 لتعديل المسألة القانونية المحدّدة.