REST Resource: matters.holds

Resource: Hold

A hold. A hold prevents the specified Google Workspace service from purging data for specific accounts or all members of an organizational unit.

To work with Vault resources, the account must have the required Vault privileges 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.

JSON representation
{
  "holdId": string,
  "name": string,
  "updateTime": string,
  "accounts": [
    {
      object (HeldAccount)
    }
  ],
  "orgUnit": {
    object (HeldOrgUnit)
  },
  "corpus": enum (CorpusType),
  "query": {
    object (CorpusQuery)
  }
}
Fields
holdId

string

The unique immutable ID of the hold. Assigned during creation.

name

string

The name of the hold.

updateTime

string (Timestamp format)

The last time this hold was modified.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

accounts[]

object (HeldAccount)

If set, the hold applies to the specified accounts and orgUnit must be empty.

orgUnit

object (HeldOrgUnit)

If set, the hold applies to all members of the organizational unit and accounts must be empty. This property is mutable. For Groups holds, set accounts.

corpus

enum (CorpusType)

The service to be searched.

query

object (CorpusQuery)

Service-specific options. If set, CorpusQuery must match CorpusType.

HeldOrgUnit

The organizational unit covered by a hold. This structure is immutable.

JSON representation
{
  "orgUnitId": string,
  "holdTime": string
}
Fields
orgUnitId

string

The organizational unit's immutable ID as provided by the Admin SDK.

holdTime

string (Timestamp format)

When the organizational unit was put on hold. This property is immutable.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

CorpusQuery

Service-specific options for holds.

JSON representation
{

  // 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)
  }
  // End of list of possible types for union field corpus_query.
}
Fields
Union field corpus_query. If set, this must match the service type. corpus_query can be only one of the following:
driveQuery

object (HeldDriveQuery)

Service-specific options for Drive holds. If set, CorpusType must be DRIVE.

mailQuery

object (HeldMailQuery)

Service-specific options for Gmail holds. If set, CorpusType must be MAIL.

groupsQuery

object (HeldGroupsQuery)

Service-specific options for Groups holds. If set, CorpusType must be GROUPS.

hangoutsChatQuery

object (HeldHangoutsChatQuery)

Service-specific options for Chat holds. If set, CorpusType must be HANGOUTS_CHAT.

voiceQuery

object (HeldVoiceQuery)

Service-specific options for Voice holds. If set, CorpusType must be VOICE.

HeldDriveQuery

Options for Drive holds.

JSON representation
{
  "includeTeamDriveFiles": boolean,
  "includeSharedDriveFiles": boolean
}
Fields
includeTeamDriveFiles
(deprecated)

boolean

To include files in Team Drives in the hold, set to true.

includeSharedDriveFiles

boolean

To include files in shared drives in the hold, set to true.

HeldMailQuery

Query options for Gmail holds.

JSON representation
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Fields
terms

string

The search operators used to refine the messages covered by the hold.

startTime

string (Timestamp format)

The start time for the query. Specify in GMT. The value is rounded to 12 AM on the specified date.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

The end time for the query. Specify in GMT. The value is rounded to 12 AM on the specified date.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

HeldGroupsQuery

Query options for group holds.

JSON representation
{
  "terms": string,
  "startTime": string,
  "endTime": string
}
Fields
terms

string

The search operators used to refine the messages covered by the hold.

startTime

string (Timestamp format)

The start time for the query. Specify in GMT. The value is rounded to 12 AM on the specified date.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

The end time for the query. Specify in GMT. The value is rounded to 12 AM on the specified date.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

HeldHangoutsChatQuery

Options for Chat holds.

JSON representation
{
  "includeRooms": boolean
}
Fields
includeRooms

boolean

To include messages in Chat spaces the user was a member of, set to true.

HeldVoiceQuery

Options for Voice holds.

JSON representation
{
  "coveredData": [
    enum (VoiceCoveredData)
  ]
}
Fields
coveredData[]

enum (VoiceCoveredData)

A list of data types covered by the hold. Should be non-empty. Order does not matter and duplicates are ignored.

Methods

addHeldAccounts

Adds accounts to a hold.

create

Creates a hold in the specified matter.

delete

Removes the specified hold and releases the accounts or organizational unit covered by the hold.

get

Gets the specified hold.

list

Lists the holds in a matter.

removeHeldAccounts

Removes the specified accounts from a hold.

update

Updates the scope (organizational unit or accounts) and query parameters of a hold.