REST Resource: matters.holds

Tài nguyên: Lưu giữ

Yêu cầu lưu giữ dữ liệu. Yêu cầu lưu giữ dữ liệu ngăn dịch vụ Google Workspace được chỉ định xoá hoàn toàn dữ liệu đối với những tài khoản cụ thể hoặc tất cả thành viên của một đơn vị tổ chức.

Để làm việc với các tài nguyên của Vault, tài khoản này phải có các đặc quyền cần thiết của Vault và quyền truy cập vào vấn đề đó. Để truy cập vào một vấn đề, tài khoản đó phải là người đã tạo vấn đề, đã chia sẻ vấn đề đó với họ hoặc có đặc quyền Xem tất cả vấn đề.

Biểu diễn dưới dạng JSON 
{
  "holdId": string,
  "name": string,
  "updateTime": string,
  "accounts": [
    {
      object (HeldAccount)
    }
  ],
  "orgUnit": {
    object (HeldOrgUnit)
  },
  "corpus": enum (CorpusType),
  "query": {
    object (CorpusQuery)
  }
}
Trường
holdId

string

Mã nhận dạng không thể thay đổi duy nhất của yêu cầu lưu giữ dữ liệu. Được chỉ định trong quá trình tạo.
name

string

Tên yêu cầu lưu giữ dữ liệu.
updateTime

string (Timestamp format)

Lần gần đây nhất yêu cầu lưu giữ dữ liệu này được sửa đổi.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
accounts[]

object (HeldAccount)

Nếu được đặt, yêu cầu lưu giữ dữ liệu sẽ áp dụng cho những tài khoản đã chỉ định và orgUnit phải để trống.
orgUnit

object (HeldOrgUnit)

Nếu được đặt, yêu cầu lưu giữ dữ liệu sẽ áp dụng cho mọi thành viên của đơn vị tổ chức và tài khoản phải để trống. Thuộc tính này có thể thay đổi. Đối với yêu cầu lưu giữ dữ liệu trên Groups, hãy thiết lập tài khoản.
corpus

enum (CorpusType)

Dịch vụ được tìm kiếm.
query

object (CorpusQuery)

Các lựa chọn dành riêng cho từng dịch vụ. Nếu được đặt, CorpusQuery phải khớp với CorpusType.

HeldOrgUnit

Đơn vị tổ chức thuộc phạm vi của một yêu cầu lưu giữ dữ liệu. Cấu trúc này là bất biến.

Biểu diễn dưới dạng JSON 
{
  "orgUnitId": string,
  "holdTime": string
}
Trường
orgUnitId

string

Mã không thể thay đổi của đơn vị tổ chức do SDK quản trị cung cấp.
holdTime

string (Timestamp format)

Thời điểm đơn vị tổ chức bị tạm ngưng. Thuộc tính này là không thể thay đổi.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

CorpusQuery

Các lựa chọn dành riêng cho từng dịch vụ về yêu cầu lưu giữ dữ liệu.

Biểu diễn dưới dạng JSON 
{

  // Union field corpus_query can be only one of the following:
  "driveQuery": {
    object (HeldDriveQuery)
  },
  "mailQuery": {
    object (HeldMailQuery)
  },
  "groupsQuery": {
    object (HeldGroupsQuery)
  },
  "hangoutsChatQuery": {
    object (HeldHangoutsChatQuery)
  },
  "voiceQuery": {
    object (HeldVoiceQuery)
  },
  "calendarQuery": {
    object (HeldCalendarQuery)
  }
  // End of list of possible types for union field corpus_query.
}
Trường
Trường kết hợp corpus_query. Nếu được đặt, giá trị này phải khớp với loại dịch vụ. corpus_query chỉ có thể là một trong những trạng thái sau đây:
driveQuery

object (HeldDriveQuery)

Các lựa chọn dành riêng cho từng dịch vụ đối với yêu cầu lưu giữ dữ liệu trên Drive. Nếu được đặt, CorpusType phải là DRIVE.
mailQuery

object (HeldMailQuery)

Các lựa chọn dành riêng cho từng dịch vụ đối với yêu cầu lưu giữ dữ liệu của Gmail. Nếu đặt giá trị này, thì CorpusType phải là mail.
groupsQuery

object (HeldGroupsQuery)

Các lựa chọn dành riêng cho từng dịch vụ đối với yêu cầu lưu giữ dữ liệu của Groups. Nếu được đặt, CorpusType phải là GROUPS.
hangoutsChatQuery

object (HeldHangoutsChatQuery)

Các lựa chọn dành riêng cho từng dịch vụ đối với yêu cầu lưu giữ dữ liệu trên Chat. Nếu được đặt, thì CorpusType phải là oogleS_CUỘC TRÒ CHUYỆN.
voiceQuery

object (HeldVoiceQuery)

Các lựa chọn dành riêng cho từng dịch vụ đối với tính năng giữ lại dữ liệu của Voice. Nếu được đặt, CorpusType phải là VOICE.
calendarQuery

object (HeldCalendarQuery)

Các lựa chọn dành riêng cho từng dịch vụ đối với yêu cầu lưu giữ dữ liệu trên Lịch. Nếu được đặt, CorpusType phải là CALENDAR.

HeldDriveQuery

Các lựa chọn về yêu cầu lưu giữ dữ liệu trên Drive.

Biểu diễn dưới dạng JSON 
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
Trường
includeTeamDriveFiles
(deprecated)

boolean

Để đưa các tệp vào Drive nhóm đang lưu giữ dữ liệu, hãy đặt thành true.
includeSharedDriveFiles

boolean

Để đưa các tệp vào bộ nhớ dùng chung vào yêu cầu lưu giữ dữ liệu, hãy đặt thành true.

HeldMailQuery

Các lựa chọn truy vấn cho yêu cầu lưu giữ dữ liệu trên Gmail.

Biểu diễn dưới dạng JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Trường
terms

string

Toán tử tìm kiếm dùng để tinh chỉnh các tin nhắn có trong yêu cầu lưu giữ dữ liệu.
startTime

string (Timestamp format)

Thời gian bắt đầu truy vấn. Nêu rõ theo giờ GMT. Giá trị được làm tròn thành 12 SA vào ngày được chỉ định.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Thời gian kết thúc truy vấn. Nêu rõ theo giờ GMT. Giá trị được làm tròn thành 12 SA vào ngày được chỉ định.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

HeldGroupsQuery

Các lựa chọn truy vấn cho yêu cầu lưu giữ dữ liệu của nhóm.

Biểu diễn dưới dạng JSON 
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Trường
terms

string

Toán tử tìm kiếm dùng để tinh chỉnh các tin nhắn có trong yêu cầu lưu giữ dữ liệu.
startTime

string (Timestamp format)

Thời gian bắt đầu truy vấn. Nêu rõ theo giờ GMT. Giá trị được làm tròn thành 12 SA vào ngày được chỉ định.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Thời gian kết thúc truy vấn. Nêu rõ theo giờ GMT. Giá trị được làm tròn thành 12 SA vào ngày được chỉ định.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

HeldHangoutsChatQuery

Các lựa chọn về yêu cầu lưu giữ dữ liệu trên Chat.

Biểu diễn dưới dạng JSON 
{
  "includeRooms": boolean
}
Trường
includeRooms

boolean

Để đưa tin nhắn vào các phòng Chat mà người dùng là thành viên, hãy đặt thành true.

HeldVoiceQuery

Các lựa chọn về tính năng giữ lại giọng nói.

Biểu diễn dưới dạng JSON 
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Trường
coveredData[]

enum (VoiceCoveredData)

Danh sách các loại dữ liệu có trong yêu cầu lưu giữ dữ liệu. Không được để trống. Thứ tự không quan trọng và các mục trùng lặp sẽ bị bỏ qua.

HeldCalendarQuery

Loại này không có trường nào.

Các tuỳ chọn cho yêu cầu lưu giữ dữ liệu trên Lịch.

Phương thức

addHeldAccounts

 Thêm các tài khoản vào yêu cầu lưu giữ dữ liệu.

create

 Tạo yêu cầu lưu giữ dữ liệu đối với vấn đề đã chỉ định.

delete

 Xoá yêu cầu lưu giữ dữ liệu đã chỉ định và giải phóng các tài khoản hoặc đơn vị tổ chức thuộc phạm vi của yêu cầu lưu giữ dữ liệu đó.

get

 Lấy yêu cầu lưu giữ dữ liệu đã chỉ định.

list

 Liệt kê các yêu cầu lưu giữ dữ liệu trong một vấn đề.

removeHeldAccounts

 Xoá những tài khoản được chỉ định khỏi yêu cầu lưu giữ dữ liệu.

update

 Cập nhật phạm vi (đơn vị tổ chức hoặc tài khoản) và tham số truy vấn của một yêu cầu lưu giữ dữ liệu.