RubyGems - google-apis-vault_v1 - Versions diffs - 0.1.0 → 0.6.0 - Mend

google-apis-vault_v1 0.1.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +23 -0
data/lib/google/apis/vault_v1.rb +7 -1
data/lib/google/apis/vault_v1/classes.rb +217 -172
data/lib/google/apis/vault_v1/gem_version.rb +3 -3
data/lib/google/apis/vault_v1/service.rb +56 -52
metadata +15 -9

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1a5097ab627fa0b0601e417518388aa22220beb77aa2d2752cc3eb7ce3e5f1ae
-  data.tar.gz: cf5cf6ad0e358dbcfc7e4f018aa16158e466db615c272206cd0f7872e2ce01e5
+  metadata.gz: b705776a312e7d2b0eff0a4151e911ae0388722d30adb8094c2a17d6e2c19ed7
+  data.tar.gz: 486e349166e5c89b297889a1dd9f91f5ecb893837d89d2408970098b1c2d64ea
 SHA512:
-  metadata.gz: 4f42e6f6e09d5e87335212cb9b660c1ef0e358f99c32c50b264ff3329e10db5f8c16a5c447f21d277920b197e0d91592dd553aa8e4af925a724c567abc9e8004
-  data.tar.gz: 0c353bf43710449a82cd4e67dbd0f68ae2690fc3d2c4eb8ba4af81c344c3142f369591167784b838bcd42e6a34ea0fbf1b7412cedfea1a841101fdc6462c7fdd
+  metadata.gz: c8859c33a20f5869bfd68149ea4345103a6a870f6ada74a651ebb648a8d68bd6107509f2f962f847b536f27956fc048e5a94d31b390a81df14407c799a0591ea
+  data.tar.gz: 34ad12ac25f14a5df30c3da458c5427255c56a05abb37146233d8ce6cf26dea21900c2630878f35d916b1ad46938ad1307b46ae337513f44ca298ce27d9e3af1

data/CHANGELOG.md CHANGED Viewed

@@ -1,5 +1,28 @@
 # Release history for google-apis-vault_v1
+### v0.6.0 (2021-06-29)
+* Regenerated using generator version 0.4.0
+### v0.5.0 (2021-06-25)
+* Regenerated from discovery document revision 20210621
+* Regenerated using generator version 0.3.0
+### v0.4.0 (2021-05-20)
+* Unspecified changes
+### v0.3.0 (2021-04-28)
+* Regenerated from discovery document revision 20210419
+* Regenerated using generator version 0.2.0
+### v0.2.0 (2021-03-04)
+* Regenerated from discovery document revision 20210129
+* Regenerated using generator version 0.1.2
 ### v0.1.0 (2021-01-07)
 * Regenerated using generator version 0.1.1

data/lib/google/apis/vault_v1.rb CHANGED Viewed

@@ -21,7 +21,13 @@ module Google
   module Apis
     # G Suite Vault API
     #
-    # Archiving and eDiscovery for G Suite.
+    # Retention and eDiscovery for Google Workspace. To 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. For example, to download an export,
+    # an account needs the **Manage Exports** privilege and the matter shared with
+    # them.
     #
     # @see https://developers.google.com/vault
     module VaultV1

data/lib/google/apis/vault_v1/classes.rb CHANGED Viewed

@@ -22,7 +22,7 @@ module Google
   module Apis
     module VaultV1
-      # Count number for each account.
+      # The results count for each account.
       class AccountCount
         include Google::Apis::Core::Hashable
@@ -31,7 +31,7 @@ module Google
         # @return [Google::Apis::VaultV1::UserInfo]
         attr_accessor :account
-        # The number of artifacts found for this account.
+        # The number of results (messages or files) found for this account.
         # Corresponds to the JSON property `count`
         # @return [Fixnum]
         attr_accessor :count
@@ -72,7 +72,7 @@ module Google
         end
       end
-      # Accounts to search
+      # The accounts to search
       class AccountInfo
         include Google::Apis::Core::Hashable
@@ -91,13 +91,16 @@ module Google
         end
       end
-      # A status detailing the status of each account creation, and the HeldAccount,
-      # if successful.
+      # The status of each account creation, and the **HeldAccount**, if successful.
       class AddHeldAccountResult
         include Google::Apis::Core::Hashable
-        # An account being held in a particular hold. This structure is immutable. This
-        # can be either a single user or a google group, depending on the corpus.
+        # An account covered by a hold. This structure is immutable. It can be an
+        # individual account or a Google Group, depending on the service. To 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.
         # Corresponds to the JSON property `account`
         # @return [Google::Apis::VaultV1::HeldAccount]
         attr_accessor :account
@@ -127,14 +130,14 @@ module Google
       class AddHeldAccountsRequest
         include Google::Apis::Core::Hashable
-        # Account IDs to identify which accounts to add. Only account_ids or only emails
-        # should be specified, but not both.
+        # A comma-separated list of the account IDs of the accounts to add to the hold.
+        # Specify either **emails** or **account_ids**, but not both.
         # Corresponds to the JSON property `accountIds`
         # @return [Array<String>]
         attr_accessor :account_ids
-        # Emails to identify which accounts to add. Only emails or only account_ids
-        # should be specified, but not both.
+        # A comma-separated list of the emails of the accounts to add to the hold.
+        # Specify either **emails** or **account_ids**, but not both.
         # Corresponds to the JSON property `emails`
         # @return [Array<String>]
         attr_accessor :emails
@@ -170,26 +173,26 @@ module Google
       end
       # Add an account with the permission specified. The role cannot be owner. If an
-      # account already has a role in the matter, it will be overwritten.
+      # account already has a role in the matter, the existing role is overwritten.
       class AddMatterPermissionsRequest
         include Google::Apis::Core::Hashable
-        # Only relevant if send_emails is true. True to CC requestor in the email
-        # message. False to not CC requestor.
+        # Only relevant if **sendEmails** is **true**. To CC the requestor in the email
+        # message, set to **true**. To not CC requestor, set to **false**.
         # Corresponds to the JSON property `ccMe`
         # @return [Boolean]
         attr_accessor :cc_me
         alias_method :cc_me?, :cc_me
-        # Currently each matter only has one owner, and all others are collaborators.
-        # When an account is purged, its corresponding MatterPermission resources cease
-        # to exist.
+        # Users 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.
         # Corresponds to the JSON property `matterPermission`
         # @return [Google::Apis::VaultV1::MatterPermission]
         attr_accessor :matter_permission
-        # True to send notification email to the added account. False to not send
-        # notification email.
+        # To send a notification email to the added account, set to **true**. To not
+        # send a notification email, set to **false**.
         # Corresponds to the JSON property `sendEmails`
         # @return [Boolean]
         attr_accessor :send_emails
@@ -237,7 +240,11 @@ module Google
       class CloseMatterResponse
         include Google::Apis::Core::Hashable
-        # Represents a matter.
+        # Represents a matter. To 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.
         # Corresponds to the JSON property `matter`
         # @return [Google::Apis::VaultV1::Matter]
         attr_accessor :matter
@@ -252,13 +259,15 @@ module Google
         end
       end
-      # An export file on cloud storage
+      # The export file in Cloud Storage
       class CloudStorageFile
         include Google::Apis::Core::Hashable
-        # The cloud storage bucket name of this export file. Can be used in cloud
-        # storage JSON/XML API, but not to list the bucket contents. Instead, you can
-        # get individual export files by object name.
+        # The name of the Cloud Storage bucket for the export file. You can use this
+        # value in the [Cloud Storage JSON or XML APIs](https://cloud.google.com/storage/
+        # docs/apis), but not to list the bucket contents. Instead, you can [get
+        # individual export files](https://cloud.google.com/storage/docs/json_api/v1/
+        # objects/get) by object name.
         # Corresponds to the JSON property `bucketName`
         # @return [String]
         attr_accessor :bucket_name
@@ -268,13 +277,14 @@ module Google
         # @return [String]
         attr_accessor :md5_hash
-        # The cloud storage object name of this export file. Can be used in cloud
-        # storage JSON/XML API.
+        # The name of the Cloud Storage object for the export file. You can use this
+        # value in the [Cloud Storage JSON or XML APIs](https://cloud.google.com/storage/
+        # docs/apis).
         # Corresponds to the JSON property `objectName`
         # @return [String]
         attr_accessor :object_name
-        # The size of the export file.
+        # The export file size.
         # Corresponds to the JSON property `size`
         # @return [Fixnum]
         attr_accessor :size
@@ -292,11 +302,11 @@ module Google
         end
       end
-      # Export sink for cloud storage files.
+      # Export sink for Cloud Storage files.
       class CloudStorageSink
         include Google::Apis::Core::Hashable
-        # Output only. The exported files on cloud storage.
+        # Output only. The exported files in Cloud Storage.
         # Corresponds to the JSON property `files`
         # @return [Array<Google::Apis::VaultV1::CloudStorageFile>]
         attr_accessor :files
@@ -311,11 +321,11 @@ module Google
         end
       end
-      # Corpus specific queries.
+      # Service-specific options for holds.
       class CorpusQuery
         include Google::Apis::Core::Hashable
-        # Query options for Drive holds.
+        # Options for Drive holds.
         # Corresponds to the JSON property `driveQuery`
         # @return [Google::Apis::VaultV1::HeldDriveQuery]
         attr_accessor :drive_query
@@ -325,17 +335,17 @@ module Google
         # @return [Google::Apis::VaultV1::HeldGroupsQuery]
         attr_accessor :groups_query
-        # Query options for hangouts chat holds.
+        # Options for Chat holds.
         # Corresponds to the JSON property `hangoutsChatQuery`
         # @return [Google::Apis::VaultV1::HeldHangoutsChatQuery]
         attr_accessor :hangouts_chat_query
-        # Query options for mail holds.
+        # Query options for Gmail holds.
         # Corresponds to the JSON property `mailQuery`
         # @return [Google::Apis::VaultV1::HeldMailQuery]
         attr_accessor :mail_query
-        # Query options for Voice holds.
+        # Options for Voice holds.
         # Corresponds to the JSON property `voiceQuery`
         # @return [Google::Apis::VaultV1::HeldVoiceQuery]
         attr_accessor :voice_query
@@ -368,7 +378,7 @@ module Google
         # @return [String]
         attr_accessor :matter_id
-        # A query definition relevant for search & export.
+        # The query definition used for search and export.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::VaultV1::Query]
         attr_accessor :query
@@ -395,12 +405,12 @@ module Google
       class CountArtifactsRequest
         include Google::Apis::Core::Hashable
-        # A query definition relevant for search & export.
+        # The query definition used for search and export.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::VaultV1::Query]
         attr_accessor :query
-        # Specifies the granularity of the count result returned in response.
+        # Sets the granularity of the count results.
         # Corresponds to the JSON property `view`
         # @return [String]
         attr_accessor :view
@@ -425,12 +435,12 @@ module Google
         # @return [Google::Apis::VaultV1::GroupsCountResult]
         attr_accessor :groups_count_result
-        # Mail specific count metrics.
+        # Gmail and classic Hangouts-specific count metrics.
         # Corresponds to the JSON property `mailCountResult`
         # @return [Google::Apis::VaultV1::MailCountResult]
         attr_accessor :mail_count_result
-        # Total count of artifacts. For mail and groups, artifacts refers to messages.
+        # Total count of messages.
         # Corresponds to the JSON property `totalCount`
         # @return [Fixnum]
         attr_accessor :total_count
@@ -447,12 +457,12 @@ module Google
         end
       end
-      # The options for Drive export.
+      # Options for Drive exports.
       class DriveExportOptions
         include Google::Apis::Core::Hashable
-        # Set to true to include access level information for users with indirect access
-        # to files.
+        # To include access level information for users with [indirect access](https://
+        # support.google.com/vault/answer/6099459#metadata) to files, set to **true**.
         # Corresponds to the JSON property `includeAccessInfo`
         # @return [Boolean]
         attr_accessor :include_access_info
@@ -468,11 +478,11 @@ module Google
         end
       end
-      # Drive search advanced options
+      # Additional options for Drive search
       class DriveOptions
         include Google::Apis::Core::Hashable
-        # Set to true to include shared drive.
+        # Set to **true** to include shared drives.
         # Corresponds to the JSON property `includeSharedDrives`
         # @return [Boolean]
         attr_accessor :include_shared_drives
@@ -484,8 +494,9 @@ module Google
         attr_accessor :include_team_drives
         alias_method :include_team_drives?, :include_team_drives
-        # Search the versions of the Drive file as of the reference date. These
-        # timestamps are in GMT and rounded down to the given date.
+        # Search the current version of the Drive file, but export the contents of the
+        # last version saved before 12:00 AM UTC on the specified date. Enter the date
+        # in UTC.
         # Corresponds to the JSON property `versionDate`
         # @return [String]
         attr_accessor :version_date
@@ -519,11 +530,14 @@ module Google
         end
       end
-      # An export
+      # An export. To 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.
       class Export
         include Google::Apis::Core::Hashable
-        # Export sink for cloud storage files.
+        # Export sink for Cloud Storage files.
         # Corresponds to the JSON property `cloudStorageSink`
         # @return [Google::Apis::VaultV1::CloudStorageSink]
         attr_accessor :cloud_storage_sink
@@ -533,7 +547,7 @@ module Google
         # @return [String]
         attr_accessor :create_time
-        # Export advanced options
+        # Additional options for exports
         # Corresponds to the JSON property `exportOptions`
         # @return [Google::Apis::VaultV1::ExportOptions]
         attr_accessor :export_options
@@ -553,7 +567,7 @@ module Google
         # @return [String]
         attr_accessor :name
-        # A query definition relevant for search & export.
+        # The query definition used for search and export.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::VaultV1::Query]
         attr_accessor :query
@@ -563,12 +577,12 @@ module Google
         # @return [Google::Apis::VaultV1::UserInfo]
         attr_accessor :requester
-        # Stats of an export.
+        # Progress information for an export.
         # Corresponds to the JSON property `stats`
         # @return [Google::Apis::VaultV1::ExportStats]
         attr_accessor :stats
-        # Output only. The export status.
+        # Output only. The status of the export.
         # Corresponds to the JSON property `status`
         # @return [String]
         attr_accessor :status
@@ -592,36 +606,36 @@ module Google
         end
       end
-      # Export advanced options
+      # Additional options for exports
       class ExportOptions
         include Google::Apis::Core::Hashable
-        # The options for Drive export.
+        # Options for Drive exports.
         # Corresponds to the JSON property `driveOptions`
         # @return [Google::Apis::VaultV1::DriveExportOptions]
         attr_accessor :drive_options
-        # The options for groups export.
+        # Options for Groups exports.
         # Corresponds to the JSON property `groupsOptions`
         # @return [Google::Apis::VaultV1::GroupsExportOptions]
         attr_accessor :groups_options
-        # The options for hangouts chat export.
+        # Options for Chat exports.
         # Corresponds to the JSON property `hangoutsChatOptions`
         # @return [Google::Apis::VaultV1::HangoutsChatExportOptions]
         attr_accessor :hangouts_chat_options
-        # The options for mail export.
+        # Options for Gmail exports.
         # Corresponds to the JSON property `mailOptions`
         # @return [Google::Apis::VaultV1::MailExportOptions]
         attr_accessor :mail_options
-        # The requested export location.
+        # The requested data region for the export.
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
-        # The options for voice export.
+        # The options for Voice exports.
         # Corresponds to the JSON property `voiceOptions`
         # @return [Google::Apis::VaultV1::VoiceExportOptions]
         attr_accessor :voice_options
@@ -641,11 +655,11 @@ module Google
         end
       end
-      # Stats of an export.
+      # Progress information for an export.
       class ExportStats
         include Google::Apis::Core::Hashable
-        # The number of documents already processed by the export.
+        # The number of messages or files already processed for export.
         # Corresponds to the JSON property `exportedArtifactCount`
         # @return [Fixnum]
         attr_accessor :exported_artifact_count
@@ -655,7 +669,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :size_in_bytes
-        # The number of documents to be exported.
+        # The number of messages or files to be exported.
         # Corresponds to the JSON property `totalArtifactCount`
         # @return [Fixnum]
         attr_accessor :total_artifact_count
@@ -691,9 +705,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :matching_accounts_count
-        # When data scope is HELD_DATA in the request Query, these accounts in the
-        # request are not queried because they are not on hold. For other data scope,
-        # this field is not set.
+        # When **DataScope** is **HELD_DATA**, these accounts in the request are not
+        # queried because they are not on hold. For other data scope, this field is not
+        # set.
         # Corresponds to the JSON property `nonQueryableAccounts`
         # @return [Array<String>]
         attr_accessor :non_queryable_accounts
@@ -717,11 +731,11 @@ module Google
         end
       end
-      # The options for groups export.
+      # Options for Groups exports.
       class GroupsExportOptions
         include Google::Apis::Core::Hashable
-        # The export format for groups export.
+        # The file format for exported messages.
         # Corresponds to the JSON property `exportFormat`
         # @return [String]
         attr_accessor :export_format
@@ -736,11 +750,11 @@ module Google
         end
       end
-      # The options for hangouts chat export.
+      # Options for Chat exports.
       class HangoutsChatExportOptions
         include Google::Apis::Core::Hashable
-        # The export format for hangouts chat export.
+        # The file format for exported messages.
         # Corresponds to the JSON property `exportFormat`
         # @return [String]
         attr_accessor :export_format
@@ -755,11 +769,12 @@ module Google
         end
       end
-      # Accounts to search
+      # The Chat spaces to search
       class HangoutsChatInfo
         include Google::Apis::Core::Hashable
-        # A set of rooms to search.
+        # A list of Chat spaces IDs, as provided by the [Chat API](https://developers.
+        # google.com/hangouts/chat).
         # Corresponds to the JSON property `roomId`
         # @return [Array<String>]
         attr_accessor :room_id
@@ -774,11 +789,12 @@ module Google
         end
       end
-      # Hangouts chat search advanced options
+      # Additional options for Google Chat search
       class HangoutsChatOptions
         include Google::Apis::Core::Hashable
-        # Set to true to include rooms.
+        # For searches by account or organizational unit, set to **true** to include
+        # rooms.
         # Corresponds to the JSON property `includeRooms`
         # @return [Boolean]
         attr_accessor :include_rooms
@@ -794,18 +810,23 @@ module Google
         end
       end
-      # An account being held in a particular hold. This structure is immutable. This
-      # can be either a single user or a google group, depending on the corpus.
+      # An account covered by a hold. This structure is immutable. It can be an
+      # individual account or a Google Group, depending on the service. To 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.
       class HeldAccount
         include Google::Apis::Core::Hashable
-        # The account's ID as provided by the Admin SDK.
+        # The account ID, as provided by the [Admin SDK](https://developers.google.com/
+        # admin-sdk/).
         # Corresponds to the JSON property `accountId`
         # @return [String]
         attr_accessor :account_id
         # The primary email address of the account. If used as an input, this takes
-        # precedence over account ID.
+        # precedence over **accountId**.
         # Corresponds to the JSON property `email`
         # @return [String]
         attr_accessor :email
@@ -839,17 +860,17 @@ module Google
         end
       end
-      # Query options for Drive holds.
+      # Options for Drive holds.
       class HeldDriveQuery
         include Google::Apis::Core::Hashable
-        # If true, include files in shared drives in the hold.
+        # To include files in shared drives in the hold, set to **true**.
         # Corresponds to the JSON property `includeSharedDriveFiles`
         # @return [Boolean]
         attr_accessor :include_shared_drive_files
         alias_method :include_shared_drive_files?, :include_shared_drive_files
-        # If true, include files in Team Drives in the hold.
+        # To include files in Team Drives in the hold, set to **true**.
         # Corresponds to the JSON property `includeTeamDriveFiles`
         # @return [Boolean]
         attr_accessor :include_team_drive_files
@@ -870,19 +891,20 @@ module Google
       class HeldGroupsQuery
         include Google::Apis::Core::Hashable
-        # The end time range for the search query. These timestamps are in GMT and
-        # rounded down to the start of the given date.
+        # The end time for the query. Specify in GMT. The value is rounded to 12 AM on
+        # the specified date.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
-        # The start time range for the search query. These timestamps are in GMT and
-        # rounded down to the start of the given date.
+        # The start time for the query. Specify in GMT. The value is rounded to 12 AM on
+        # the specified date.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
-        # The search terms for the hold.
+        # The [search operators](https://support.google.com/vault/answer/2474474) used
+        # to refine the messages covered by the hold.
         # Corresponds to the JSON property `terms`
         # @return [String]
         attr_accessor :terms
@@ -899,11 +921,11 @@ module Google
         end
       end
-      # Query options for hangouts chat holds.
+      # Options for Chat holds.
       class HeldHangoutsChatQuery
         include Google::Apis::Core::Hashable
-        # If true, include rooms the user has participated in.
+        # To include messages in Chat spaces the user was a member of, set to **true**.
         # Corresponds to the JSON property `includeRooms`
         # @return [Boolean]
         attr_accessor :include_rooms
@@ -919,23 +941,24 @@ module Google
         end
       end
-      # Query options for mail holds.
+      # Query options for Gmail holds.
       class HeldMailQuery
         include Google::Apis::Core::Hashable
-        # The end time range for the search query. These timestamps are in GMT and
-        # rounded down to the start of the given date.
+        # The end time for the query. Specify in GMT. The value is rounded to 12 AM on
+        # the specified date.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
-        # The start time range for the search query. These timestamps are in GMT and
-        # rounded down to the start of the given date.
+        # The start time for the query. Specify in GMT. The value is rounded to 12 AM on
+        # the specified date.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
-        # The search terms for the hold.
+        # The [search operators](https://support.google.com/vault/answer/2474474) used
+        # to refine the messages covered by the hold.
         # Corresponds to the JSON property `terms`
         # @return [String]
         attr_accessor :terms
@@ -952,17 +975,17 @@ module Google
         end
       end
-      # A organizational unit being held in a particular hold. This structure is
-      # immutable.
+      # The organizational unit covered by a hold. This structure is immutable.
       class HeldOrgUnit
         include Google::Apis::Core::Hashable
-        # When the org unit was put on hold. This property is immutable.
+        # When the organizational unit was put on hold. This property is immutable.
         # Corresponds to the JSON property `holdTime`
         # @return [String]
         attr_accessor :hold_time
-        # The org unit's immutable ID as provided by the Admin SDK.
+        # The organizational unit's immutable ID as provided by the [Admin SDK](https://
+        # developers.google.com/admin-sdk/).
         # Corresponds to the JSON property `orgUnitId`
         # @return [String]
         attr_accessor :org_unit_id
@@ -978,12 +1001,12 @@ module Google
         end
       end
-      # Query options for Voice holds.
+      # Options for Voice holds.
       class HeldVoiceQuery
         include Google::Apis::Core::Hashable
-        # Data covered by this rule. Should be non-empty. Order does not matter and
-        # duplicates will be ignored.
+        # A list of data types covered by the hold. Should be non-empty. Order does not
+        # matter and duplicates are ignored.
         # Corresponds to the JSON property `coveredData`
         # @return [Array<String>]
         attr_accessor :covered_data
@@ -998,19 +1021,22 @@ module Google
         end
       end
-      # Represents a hold within Vault. A hold restricts purging of artifacts based on
-      # the combination of the query and accounts restrictions. A hold can be
-      # configured to either apply to an explicitly configured set of accounts, or can
-      # be applied to all members of an organizational unit.
+      # 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] (
+      # 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.
       class Hold
         include Google::Apis::Core::Hashable
-        # If set, the hold applies to the enumerated accounts and org_unit must be empty.
+        # If set, the hold applies to the specified accounts and **orgUnit** must be
+        # empty.
         # Corresponds to the JSON property `accounts`
         # @return [Array<Google::Apis::VaultV1::HeldAccount>]
         attr_accessor :accounts
-        # The corpus to be searched.
+        # The service to be searched.
         # Corresponds to the JSON property `corpus`
         # @return [String]
         attr_accessor :corpus
@@ -1025,13 +1051,12 @@ module Google
         # @return [String]
         attr_accessor :name
-        # A organizational unit being held in a particular hold. This structure is
-        # immutable.
+        # The organizational unit covered by a hold. This structure is immutable.
         # Corresponds to the JSON property `orgUnit`
         # @return [Google::Apis::VaultV1::HeldOrgUnit]
         attr_accessor :org_unit
-        # Corpus specific queries.
+        # Service-specific options for holds.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::VaultV1::CorpusQuery]
         attr_accessor :query
@@ -1057,7 +1082,7 @@ module Google
         end
       end
-      # The holds for a matter.
+      # The exports for a matter.
       class ListExportsResponse
         include Google::Apis::Core::Hashable
@@ -1082,7 +1107,7 @@ module Google
         end
       end
-      # Returns a list of held accounts for a hold.
+      # Returns a list of the accounts covered by a hold.
       class ListHeldAccountsResponse
         include Google::Apis::Core::Hashable
@@ -1187,7 +1212,7 @@ module Google
         # @return [String]
         attr_accessor :next_page_token
-        # List of output saved queries.
+        # List of saved queries.
         # Corresponds to the JSON property `savedQueries`
         # @return [Array<Google::Apis::VaultV1::SavedQuery>]
         attr_accessor :saved_queries
@@ -1203,11 +1228,11 @@ module Google
         end
       end
-      # Mail specific count metrics.
+      # Gmail and classic Hangouts-specific count metrics.
       class MailCountResult
         include Google::Apis::Core::Hashable
-        # Error occurred when querying these accounts.
+        # Errors occurred when querying these accounts.
         # Corresponds to the JSON property `accountCountErrors`
         # @return [Array<Google::Apis::VaultV1::AccountCountError>]
         attr_accessor :account_count_errors
@@ -1222,9 +1247,9 @@ module Google
         # @return [Fixnum]
         attr_accessor :matching_accounts_count
-        # When data scope is HELD_DATA in the request Query, these accounts in the
-        # request are not queried because they are not on hold. For other data scope,
-        # this field is not set.
+        # When **DataScope** is **HELD_DATA**, the number of accounts in the request
+        # that are not queried because they are not on hold. For other data scopes, this
+        # field is not set.
         # Corresponds to the JSON property `nonQueryableAccounts`
         # @return [Array<String>]
         attr_accessor :non_queryable_accounts
@@ -1248,16 +1273,16 @@ module Google
         end
       end
-      # The options for mail export.
+      # Options for Gmail exports.
       class MailExportOptions
         include Google::Apis::Core::Hashable
-        # The export file format.
+        # The file format for exported messages.
         # Corresponds to the JSON property `exportFormat`
         # @return [String]
         attr_accessor :export_format
-        # Set to true to export confidential mode content.
+        # To export confidential mode content, set to **true**.
         # Corresponds to the JSON property `showConfidentialModeContent`
         # @return [Boolean]
         attr_accessor :show_confidential_mode_content
@@ -1274,11 +1299,11 @@ module Google
         end
       end
-      # Mail search advanced options
+      # Additional options for Gmail search
       class MailOptions
         include Google::Apis::Core::Hashable
-        # Set to true to exclude drafts.
+        # Set to **true** to exclude drafts.
         # Corresponds to the JSON property `excludeDrafts`
         # @return [Boolean]
         attr_accessor :exclude_drafts
@@ -1294,23 +1319,27 @@ module Google
         end
       end
-      # Represents a matter.
+      # Represents a matter. To 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.
       class Matter
         include Google::Apis::Core::Hashable
-        # The description of the matter.
+        # An optional description for the matter.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
-        # The matter ID which is generated by the server. Should be blank when creating
-        # a new matter.
+        # The matter ID, which is generated by the server. Leave blank when creating a
+        # matter.
         # Corresponds to the JSON property `matterId`
         # @return [String]
         attr_accessor :matter_id
-        # List of users and access to the matter. Currently there is no programmer
-        # defined limit on the number of permissions a matter can have.
+        # 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.
         # Corresponds to the JSON property `matterPermissions`
         # @return [Array<Google::Apis::VaultV1::MatterPermission>]
         attr_accessor :matter_permissions
@@ -1339,18 +1368,19 @@ module Google
         end
       end
-      # Currently each matter only has one owner, and all others are collaborators.
-      # When an account is purged, its corresponding MatterPermission resources cease
-      # to exist.
+      # Users 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.
       class MatterPermission
         include Google::Apis::Core::Hashable
-        # The account ID, as provided by Admin SDK.
+        # The account ID, as provided by the [Admin SDK](https://developers.google.com/
+        # admin-sdk/).
         # Corresponds to the JSON property `accountId`
         # @return [String]
         attr_accessor :account_id
-        # The user's role in this matter.
+        # The user's role for the matter.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -1428,11 +1458,12 @@ module Google
         end
       end
-      # Org Unit to search
+      # The organizational unit to search
       class OrgUnitInfo
         include Google::Apis::Core::Hashable
-        # Org unit to search, as provided by the Admin SDK Directory API.
+        # The name of the organizational unit to search, as provided by the [Admin SDK
+        # Directory API](https://developers.google.com/admin-sdk/directory/).
         # Corresponds to the JSON property `orgUnitId`
         # @return [String]
         attr_accessor :org_unit_id
@@ -1447,60 +1478,59 @@ module Google
         end
       end
-      # A query definition relevant for search & export.
+      # The query definition used for search and export.
       class Query
         include Google::Apis::Core::Hashable
-        # Accounts to search
+        # The accounts to search
         # Corresponds to the JSON property `accountInfo`
         # @return [Google::Apis::VaultV1::AccountInfo]
         attr_accessor :account_info
-        # The corpus to search.
+        # The Google Workspace service to search.
         # Corresponds to the JSON property `corpus`
         # @return [String]
         attr_accessor :corpus
-        # The data source to search from.
+        # The data source to search.
         # Corresponds to the JSON property `dataScope`
         # @return [String]
         attr_accessor :data_scope
-        # Drive search advanced options
+        # Additional options for Drive search
         # Corresponds to the JSON property `driveOptions`
         # @return [Google::Apis::VaultV1::DriveOptions]
         attr_accessor :drive_options
-        # The end time range for the search query. These timestamps are in GMT and
-        # rounded down to the start of the given date.
+        # The end time for the search query. Specify in GMT. The value is rounded to 12
+        # AM on the specified date.
         # Corresponds to the JSON property `endTime`
         # @return [String]
         attr_accessor :end_time
-        # Accounts to search
+        # The Chat spaces to search
         # Corresponds to the JSON property `hangoutsChatInfo`
         # @return [Google::Apis::VaultV1::HangoutsChatInfo]
         attr_accessor :hangouts_chat_info
-        # Hangouts chat search advanced options
+        # Additional options for Google Chat search
         # Corresponds to the JSON property `hangoutsChatOptions`
         # @return [Google::Apis::VaultV1::HangoutsChatOptions]
         attr_accessor :hangouts_chat_options
-        # Mail search advanced options
+        # Additional options for Gmail search
         # Corresponds to the JSON property `mailOptions`
         # @return [Google::Apis::VaultV1::MailOptions]
         attr_accessor :mail_options
-        # The search method to use. This field is similar to the search_method field but
-        # is introduced to support shared drives. It supports all search method types.
-        # In case the search_method is TEAM_DRIVE the response of this field will be
-        # SHARED_DRIVE only.
+        # The entity to search. This field replaces **searchMethod** to support shared
+        # drives. When **searchMethod** is **TEAM_DRIVE**, the response of this field is
+        # **SHARED_DRIVE**.
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
-        # Org Unit to search
+        # The organizational unit to search
         # Corresponds to the JSON property `orgUnitInfo`
         # @return [Google::Apis::VaultV1::OrgUnitInfo]
         attr_accessor :org_unit_info
@@ -1510,13 +1540,13 @@ module Google
         # @return [String]
         attr_accessor :search_method
-        # Shared drives to search
+        # The shared drives to search
         # Corresponds to the JSON property `sharedDriveInfo`
         # @return [Google::Apis::VaultV1::SharedDriveInfo]
         attr_accessor :shared_drive_info
-        # The start time range for the search query. These timestamps are in GMT and
-        # rounded down to the start of the given date.
+        # The start time for the search query. Specify in GMT. The value is rounded to
+        # 12 AM on the specified date.
         # Corresponds to the JSON property `startTime`
         # @return [String]
         attr_accessor :start_time
@@ -1526,18 +1556,22 @@ module Google
         # @return [Google::Apis::VaultV1::TeamDriveInfo]
         attr_accessor :team_drive_info
-        # The corpus-specific search operators used to generate search results.
+        # Service-specific [search operators](https://support.google.com/vault/answer/
+        # 2474474) to filter search results.
         # Corresponds to the JSON property `terms`
         # @return [String]
         attr_accessor :terms
         # The time zone name. It should be an IANA TZ name, such as "America/Los_Angeles"
-        # . For more information, see Time Zone.
+        # . For a list of time zone names, see [Time Zone](https://en.wikipedia.org/wiki/
+        # List_of_tz_database_time_zones). For more information about how Vault uses
+        # time zones, see [the Vault help center](https://support.google.com/vault/
+        # answer/6092995#time).
         # Corresponds to the JSON property `timeZone`
         # @return [String]
         attr_accessor :time_zone
-        # Voice search options
+        # Additional options for Voice search
         # Corresponds to the JSON property `voiceOptions`
         # @return [Google::Apis::VaultV1::VoiceOptions]
         attr_accessor :voice_options
@@ -1572,7 +1606,7 @@ module Google
       class RemoveHeldAccountsRequest
         include Google::Apis::Core::Hashable
-        # Account IDs to identify HeldAccounts to remove.
+        # The account IDs of the accounts to remove from the hold.
         # Corresponds to the JSON property `accountIds`
         # @return [Array<String>]
         attr_accessor :account_ids
@@ -1591,8 +1625,8 @@ module Google
       class RemoveHeldAccountsResponse
         include Google::Apis::Core::Hashable
-        # A list of statuses for deleted accounts. Results have the same order as the
-        # request.
+        # A list of statuses for the deleted accounts. Results have the same order as
+        # the request.
         # Corresponds to the JSON property `statuses`
         # @return [Array<Google::Apis::VaultV1::Status>]
         attr_accessor :statuses
@@ -1643,7 +1677,11 @@ module Google
       class ReopenMatterResponse
         include Google::Apis::Core::Hashable
-        # Represents a matter.
+        # Represents a matter. To 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.
         # Corresponds to the JSON property `matter`
         # @return [Google::Apis::VaultV1::Matter]
         attr_accessor :matter
@@ -1658,27 +1696,32 @@ module Google
         end
       end
-      # Definition of the saved query.
+      # The definition of a saved query. To 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.
       class SavedQuery
         include Google::Apis::Core::Hashable
-        # Output only. The server generated timestamp at which saved query was created.
+        # Output only. The server-generated timestamp when the saved query was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
-        # Name of the saved query.
+        # The name of the saved query.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
-        # Output only. The matter ID of the associated matter. The server does not look
-        # at this field during create and always uses matter id in the URL.
+        # Output only. The matter ID of the matter the saved query is saved in. The
+        # server does not use this field during create and always uses matter ID in the
+        # URL.
         # Corresponds to the JSON property `matterId`
         # @return [String]
         attr_accessor :matter_id
-        # A query definition relevant for search & export.
+        # The query definition used for search and export.
         # Corresponds to the JSON property `query`
         # @return [Google::Apis::VaultV1::Query]
         attr_accessor :query
@@ -1702,11 +1745,12 @@ module Google
         end
       end
-      # Shared drives to search
+      # The shared drives to search
       class SharedDriveInfo
         include Google::Apis::Core::Hashable
-        # List of Shared drive IDs, as provided by Drive API.
+        # A list of shared drive IDs, as provided by the [Drive API](https://developers.
+        # google.com/drive).
         # Corresponds to the JSON property `sharedDriveIds`
         # @return [Array<String>]
         attr_accessor :shared_drive_ids
@@ -1764,7 +1808,8 @@ module Google
       class TeamDriveInfo
         include Google::Apis::Core::Hashable
-        # List of Team Drive IDs, as provided by Drive API.
+        # List of Team Drive IDs, as provided by the [Drive API](https://developers.
+        # google.com/drive).
         # Corresponds to the JSON property `teamDriveIds`
         # @return [Array<String>]
         attr_accessor :team_drive_ids
@@ -1817,11 +1862,11 @@ module Google
         end
       end
-      # The options for voice export.
+      # The options for Voice exports.
       class VoiceExportOptions
         include Google::Apis::Core::Hashable
-        # The export format for voice export.
+        # The file format for exported text messages.
         # Corresponds to the JSON property `exportFormat`
         # @return [String]
         attr_accessor :export_format
@@ -1836,7 +1881,7 @@ module Google
         end
       end
-      # Voice search options
+      # Additional options for Voice search
       class VoiceOptions
         include Google::Apis::Core::Hashable