REST Resource: matters

المرجع: Matter

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

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

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

string

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

string

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

string

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

enum (State)

حالة الطلب
matterPermissions[]

object (MatterPermission)

يسرد المستخدمين وأذوناتهم للمسألة القانونية. لا يحدّد المبرمجون حاليًا حدًا أقصى لعدد الأذونات التي يمكن أن يحصل عليها الطلب.
matterRegion

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 مالك الطلب

MatterRegion

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

عمليات التعداد
MATTER_REGION_UNSPECIFIED لم يتم تحديد المنطقة. الإعداد التلقائي هو ANY.
ANY أي منطقة
US منطقة الولايات المتحدة
EUROPE منطقة أوروبا

الطُرق

addPermissions

 تُضيف حسابًا كمتعاون في الطلب.

close

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

count

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

create

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

delete

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

get

 الحصول على المسألة المحدّدة

list

 يتم سرد كل المسائل القانونية التي حصل مقدم الطلب على إذن الوصول إليها.

removePermissions

 تزيل حسابًا كمتعاون في الطلب.

reopen

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

undelete

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

update

 تعديل المسألة المحدّدة