עניין הוא מאגר לנתונים שקשורים לנושא ספציפי, כמו תיק משפטי או חקירה. תיק משפטי כולל את הפריטים הבאים:
- שאילתות חיפוש שמורות
- השהיות
- חשבונות ששותפו איתם העניין
- ייצוא של קבוצות
- נתיב ביקורת
כדי לעבוד עם משאבים ב-Google Vault, לחשבון צריכות להיות הרשאות Vault הנדרשות וגישה לעניין. כדי לגשת לתיק, החשבון צריך ליצור את התיק, לקבל שיתוף של התיק או לקבל את ההרשאה View All Matters.
לתיק יש את המצבים הבאים:
| מדינה (State) | תיאור |
|---|---|
| פתיחה | העניין פעיל, ואפשר ליצור בו החזקות לצורך משפטי, להריץ חיפושים ולייצא נתונים. |
| סגור | בדרך כלל, כשחקירה מסתיימת, הנושא נסגר. אפשר לפתוח מחדש עניינים סגורים בכל שלב. לפני שסוגרים עניין, צריך למחוק את כל ההחזקות שמשויכות אליו. |
| נמחק | אפשר למחוק עניין כך שהוא לא יהיה זמין יותר. עניינים שנמחקו נשארים באשפה למשך כ-30 יום, ובמהלך התקופה הזו אפשר לשחזר אותם. אחרי התקופה הזו, העניין יימחק באופן סופי. אפשר למחוק רק עניינים סגורים. |

יצירת עניין
בדוגמה הבאה נוצר עניין חדש עם שם ותיאור.
Java
Matter matter = new Matter(); matter.setName("Matter Name"); matter.setDescription("Matter Description"); Matter createdMatter = client.matters().create(matter).execute();
Python
def create_matter(service): matter_content = { 'name': 'Matter Name', 'description': 'Matter Description', } matter = service.matters().create(body=matter_content).execute() return matter
קבלת עניין
יש שתי תצוגות של עניין משפטי: BASIC (ברירת מחדל) ו-FULL. בתצוגה FULL נוספות הרשאות לטיפול לתצוגה BASIC.
בדוגמה הבאה מאחזרים את העניין שצוין.
Java
client.matters().get(matterId).execute(); // Returns BASIC view. client.matters().get(matterId).setView("BASIC").execute(); client.matters().get(matterId).setView("FULL").execute();
Python
matter_id = getMatterId() service.matters().get(matterId=matter_id).execute(); // Returns BASIC view. service.matters().get(matterId=matter_id, view='BASIC').execute(); service.matters().get(matterId=matter_id, view='FULL').execute();
הצגת רשימה של matters
בדוגמה הבאה אפשר לראות איך מציגים רשימה של כל התיקים הפתוחים, הסגורים והמחוקים. כברירת מחדל, ה-API מחזיר עד 100 עניינים לכל בקשה.
Java
ListmattersList = client.matters().list().execute().getMatters();
Python
mattersList = service.matters().list().execute()
בדוגמה הבאה אפשר לראות איך מציגים רשימה של כל התיקים הפתוחים, הסגורים והמחוקים באמצעות כמה בקשות.
Java
ListMattersResponse firstPageResponse = client.matters().list().setPageSize(20).execute(); String nextPageToken = firstPageResponse.getNextPageToken(); if (nextPageToken != null) { client.matters().list().setPageToken(nextPageToken).setPageSize(20).execute(); }
Python
list_response1 = service.matters().list( view='FULL', pageSize=10).execute() for matter in list_response1['matters']: print(matter) if 'nextPageToken' in list_response1: list_response2 = service.matters().list( pageSize=10, pageToken=list_response1['nextPageToken']).execute() for matter in list_response2['matters']: print(matter)
בדוגמה הבאה מוצגות דרכים להצגת עניינים במצב מסוים.
Java
// Only get open matters. ListopenMattersList = client.matters().list().setState("OPEN") .execute().getMatters(); // Only get closed matters. List closedMattersList = client.matters().list().setState("CLOSED") .execute().getMatters(); // Only get deleted matters. List deletedMattersList = client.matters().list().setState("DELETED") .execute().getMatters();
Python
# Only get open matters. openMattersList = client.matters().list( state='OPEN').execute() # Only get closed matters. closedMattersList = client.matters().list( state='CLOSED').execute() # Only get deleted matters. deletedMattersList = client.matters().list( state='DELETED').execute()
עדכון עניין
בדוגמה הבאה מתעדכנים השם והתיאור של עניין.
Java
String matterId = "matterId"; Matter matter = new Matter().setName("New Name") .setDescription("New Description"); client.matters().update(matterId, matter).execute();
Python
def update_matter(service, matter_id): wanted_matter = { 'name': 'New Matter Name', 'description': 'New Description' } updated_matter = service.matters().update( matterId=matter_id, body=wanted_matter).execute() return updated_matter
סגירת עניין
בדוגמה הבאה אפשר לראות איך סוגרים עניין.
Java
String matterId = "matterId"; // If the matter still has holds, this operation will fail. client.matters().close(matterId, new CloseMatterRequest()).execute();
Python
def close_matter(service, matter_id): close_response = service.matters().close( matterId=matter_id, body={}).execute() return close_response['matter']
מחיקה, ביטול מחיקה או פתיחה מחדש של עניין
בדוגמה הבאה אפשר לראות איך מוחקים תיק משפטי, מבטלים את המחיקה שלו או פותחים אותו מחדש.
Java
Matter matter = client.matters().get(matterId).execute(); // Delete the matter. client.matters().delete(matter.getMatterId()); // Undelete the matter. client.matters().undelete(matter.getMatterId(), new UndeleteRequest()); // Reopen the matter. client.matters().reopen(matter.getMatterId(), new ReopenMatterRequest());
Python
def reopen_matter(service, matter_id): reopen_response = service.matters().reopen( matterId=matter_id, body={}).execute() return reopen_response['matter'] def delete_matter(service, matter_id): service.matters().delete(matterId=matter_id).execute() return get_matter(matter_id) def undelete_matter(service, matter_id): undeleted_matter = service.matters().undelete( matterId=matter_id, body={}).execute() return undeleted_matter
הרשאות בתיק משפטי
לכל עניין יש קבוצת הרשאות שקובעת למי יש גישה אליו או הרשאת עריכה שלו. אפשר לראות את זה בתצוגה FULL של עניין מסוים.
Java
String matterId = "Matter Id"; String accountId = "Account Id"; // List permissions for a matter. Matter matter = client.matters().get(matterId).setView("FULL").execute(); ListmatterPermissions = matter.getMatterPermissions(); // Add a user to the permission set. client .matters() .addPermissions(matterId) .setMatterPermissionAccountId(accountId) .setMatterPermissionRole("COLLABORATOR") .execute(); // Remove a user from the permission set. client .matters() .removePermissions(matterId) .setAccountId(accountId) .execute();
Python
def list_matter_permission(service, matter_id): matter = service.matters().get(matterId=matter_id, view='FULL').execute() return matter['matterPermissions'] def add_matter_permission(service, matter_id, account_id): permission = service.matters().addPermissions( matterId=matter_id, matterPermission_accountId=account_id, matterPermission_role='COLLABORATOR', sendEmails='False', ccMe='False').execute() return permission def remove_matter_permission(service, matter_id, account_id): service.matters().removePermissions( matterId=matter_id, accountId=account_id).execute()