กรณีคือคอนเทนเนอร์สำหรับข้อมูลที่เกี่ยวข้องกับหัวข้อที่เฉพาะเจาะจง เช่น คดีการฟ้องร้องหรือการตรวจสอบ เคสประกอบด้วยรายการต่อไปนี้
- คำค้นหาที่บันทึกไว้
- เก็บรักษาไว้
- บัญชีที่แชร์กรณีให้
- ส่งออกชุดข้อมูล
- บันทึกการตรวจสอบ
หากต้องการทำงานกับทรัพยากรของ Google ห้องนิรภัย บัญชีต้องมี สิทธิ์ของห้องนิรภัยที่จำเป็น และสิทธิ์เข้าถึงเคส หากต้องการเข้าถึงกรณี บัญชีต้องสร้างกรณี มีการแชร์กรณีกับบัญชี หรือมีสิทธิ์ดูกรณีทั้งหมด
เคสมีสถานะต่อไปนี้
| รัฐ | คำอธิบาย |
|---|---|
| เปิด | กรณีใช้งานยังคงใช้งานได้ และคุณสามารถสร้างการคงไว้ชั่วคราว เรียกใช้ การค้นหา และส่งออกข้อมูลภายในกรณีใช้งานนั้นได้ |
| ปิด | โดยปกติแล้วเมื่อการตรวจสอบเสร็จสิ้น ระบบจะปิดกรณี คุณเปิดกรณีที่ปิดไปแล้วขึ้นมาใหม่ได้ทุกเมื่อ ก่อนปิดเคส โปรดลบการเก็บรักษาทั้งหมดที่เชื่อมโยงกับเคสนั้น |
| ลบแล้ว | คุณสามารถลบเคสเพื่อให้เคสไม่พร้อมใช้งานโดยสมบูรณ์ ได้ กรณีที่ลบแล้วจะยังอยู่ในถังขยะประมาณ 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
รับเคส
มุมมองของเคสมี 2 แบบ ได้แก่ BASIC (ค่าเริ่มต้น) และ FULL FULL มุมมอง
จะเพิ่มสิทธิ์ Matter ลงในมุมมอง 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();
รายการ
ตัวอย่างต่อไปนี้แสดงวิธีแสดงรายการกรณีที่เปิด ปิด และลบแล้วทั้งหมด โดยค่าเริ่มต้น 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
สิทธิ์ของ 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()