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
} |
AclRole
أذونات المستخدم المحتملة لمسألة قانونية، بترتيب الأذونات المتزايدة
| عمليات التعداد |
ROLE_UNSPECIFIED |
لم يتمّ تخصيص أي دور. |
COLLABORATOR |
أحد المتعاونين في هذا الشأن. |
OWNER |
مالك الطلب |
MatterRegion
منطقة البيانات للمسألة القانونية.
| عمليات التعداد |
MATTER_REGION_UNSPECIFIED |
لم يتم تحديد المنطقة. الإعداد التلقائي هو ANY. |
ANY |
أي منطقة |
US |
منطقة الولايات المتحدة |
EUROPE |
منطقة أوروبا |
الطُرق |
|
|
تُضيف حسابًا كمتعاون في الطلب. |
|
|
يؤدي النقر على هذا الزر إلى إغلاق المسألة القانونية المحدّدة. |
|
|
تُحتسَب الحسابات التي تمت معالجتها من خلال طلب البحث المحدّد. |
|
|
يتم إنشاء مسألة قانونية بالاسم والوصف المُقدَّمان. |
|
|
لحذف المسألة القانونية المحدّدة. |
|
|
الحصول على المسألة المحدّدة |
|
|
يتم سرد كل المسائل القانونية التي حصل مقدم الطلب على إذن الوصول إليها. |
|
|
تؤدي هذه العملية إلى إزالة حساب كمتعاون في الطلب. |
|
|
تعيد فتح المسألة القانونية المحدّدة. |
|
|
تؤدي هذه العملية إلى إلغاء حذف المسألة القانونية المحدّدة. |
|
|
تعديل المسألة المحدّدة |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: matters\n\n- [Resource: Matter](#Matter)\n - [JSON representation](#Matter.SCHEMA_REPRESENTATION)\n- [State](#State)\n- [MatterPermission](#MatterPermission)\n - [JSON representation](#MatterPermission.SCHEMA_REPRESENTATION)\n- [AclRole](#AclRole)\n- [MatterRegion](#MatterRegion)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Matter\n----------------\n\nRepresents a matter.\n\nTo work with Vault resources, the account must have the [required Vault privileges](https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"matterId\": string, \"name\": string, \"description\": string, \"state\": enum (/workspace/vault/reference/rest/v1/matters#State), \"matterPermissions\": [ { object (/workspace/vault/reference/rest/v1/matters#MatterPermission) } ], \"matterRegion\": enum (/workspace/vault/reference/rest/v1/matters#MatterRegion) } ``` |\n\n| Fields ||\n|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `matterId` | `string` The matter ID, which is generated by the server. Leave blank when creating a matter. |\n| `name` | `string` The name of the matter. |\n| `description` | `string` An optional description for the matter. |\n| `state` | `enum (`[State](/workspace/vault/reference/rest/v1/matters#State)`)` The state of the matter. |\n| `matterPermissions[]` | `object (`[MatterPermission](/workspace/vault/reference/rest/v1/matters#MatterPermission)`)` Lists the users and their permission for the matter. Currently there is no programmer defined limit on the number of permissions a matter can have. |\n| `matterRegion` | `enum (`[MatterRegion](/workspace/vault/reference/rest/v1/matters#MatterRegion)`)` Optional. The requested data region for the matter. |\n\nState\n-----\n\nThe state of a matter.\n\n| Enums ||\n|---------------------|------------------------------------|\n| `STATE_UNSPECIFIED` | The matter has no specified state. |\n| `OPEN` | The matter is open. |\n| `CLOSED` | The matter is closed. |\n| `DELETED` | The matter is deleted. |\n\nMatterPermission\n----------------\n\nUsers can be matter owners or collaborators. Each matter has only one owner. All others users who can access the matter are collaborators. When an account is purged, its corresponding MatterPermission resources cease to exist.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"role\": enum (/workspace/vault/reference/rest/v1/matters#AclRole), \"accountId\": string } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------|\n| `role` | `enum (`[AclRole](/workspace/vault/reference/rest/v1/matters#AclRole)`)` The user's role for the matter. |\n| `accountId` | `string` The account ID, as provided by the [Admin SDK](https://developers.google.com/admin-sdk/). |\n\nAclRole\n-------\n\nThe possible user permissions for a matter, in order of increasing permissions.\n\n| Enums ||\n|--------------------|-------------------------------|\n| `ROLE_UNSPECIFIED` | No role assigned. |\n| `COLLABORATOR` | A collaborator on the matter. |\n| `OWNER` | The owner of the matter. |\n\nMatterRegion\n------------\n\nThe data region for the matter.\n\n| Enums ||\n|-----------------------------|---------------------------------------------|\n| `MATTER_REGION_UNSPECIFIED` | The region is unspecified. Defaults to ANY. |\n| `ANY` | Any region. |\n| `US` | United States region. |\n| `EUROPE` | Europe region. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------|-------------------------------------------------------|\n| ### [addPermissions](/workspace/vault/reference/rest/v1/matters/addPermissions) | Adds an account as a matter collaborator. |\n| ### [close](/workspace/vault/reference/rest/v1/matters/close) | Closes the specified matter. |\n| ### [count](/workspace/vault/reference/rest/v1/matters/count) | Counts the accounts processed by the specified query. |\n| ### [create](/workspace/vault/reference/rest/v1/matters/create) | Creates a matter with the given name and description. |\n| ### [delete](/workspace/vault/reference/rest/v1/matters/delete) | Deletes the specified matter. |\n| ### [get](/workspace/vault/reference/rest/v1/matters/get) | Gets the specified matter. |\n| ### [list](/workspace/vault/reference/rest/v1/matters/list) | Lists matters the requestor has access to. |\n| ### [removePermissions](/workspace/vault/reference/rest/v1/matters/removePermissions) | Removes an account as a matter collaborator. |\n| ### [reopen](/workspace/vault/reference/rest/v1/matters/reopen) | Reopens the specified matter. |\n| ### [undelete](/workspace/vault/reference/rest/v1/matters/undelete) | Undeletes the specified matter. |\n| ### [update](/workspace/vault/reference/rest/v1/matters/update) | Updates the specified matter. |"]]
