google-cloud-dataplex-v1 1.0.1 → 1.2.0

data/proto_docs/google/cloud/dataplex/v1/catalog.rb

@@ -21,17 +21,17 @@ module Google
   module Cloud
     module Dataplex
       module V1
-        # Aspect Type is a template for creating Aspects, and represents the
-        # JSON-schema for a given Entry, e.g., BigQuery Table Schema.
+        # AspectType is a template for creating Aspects, and represents the
+        # JSON-schema for a given Entry, for example, BigQuery Table Schema.
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The relative resource name of the AspectType, of the form:
         #     projects/\\{project_number}/locations/\\{location_id}/aspectTypes/\\{aspect_type_id}.
         # @!attribute [r] uid
         #   @return [::String]
-        #     Output only. System generated globally unique ID for the AspectType. This
-        #     ID will be different if the AspectType is deleted and re-created with the
-        #     same name.
+        #     Output only. System generated globally unique ID for the AspectType.
+        #     If you delete and recreate the AspectType with the same name, then this ID
+        #     will be different.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The time when the AspectType was created.
@@ -49,12 +49,11 @@ module Google
         #     Optional. User-defined labels for the AspectType.
         # @!attribute [rw] etag
         #   @return [::String]
-        #     This checksum is computed by the server based on the value of other
-        #     fields, and may be sent on update and delete requests to ensure the
-        #     client has an up-to-date value before proceeding.
+        #     The service computes this checksum. The client may send it on update and
+        #     delete requests to ensure it has an up-to-date value before proceeding.
         # @!attribute [rw] authorization
         #   @return [::Google::Cloud::Dataplex::V1::AspectType::Authorization]
-        #     Immutable. Authorization defined for this type.
+        #     Immutable. Defines the Authorization for this type.
         # @!attribute [rw] metadata_template
         #   @return [::Google::Cloud::Dataplex::V1::AspectType::MetadataTemplate]
         #     Required. MetadataTemplate of the aspect.
@@ -66,18 +65,18 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Autorization for an Aspect Type.
+          # Autorization for an AspectType.
           # @!attribute [rw] alternate_use_permission
           #   @return [::String]
-          #     Immutable. The IAM permission grantable on the Entry Group to allow
-          #     access to instantiate Aspects of Dataplex owned Aspect Types, only
-          #     settable for Dataplex owned Types.
+          #     Immutable. The IAM permission grantable on the EntryGroup to allow access
+          #     to instantiate Aspects of Dataplex owned AspectTypes, only settable for
+          #     Dataplex owned Types.
           class Authorization
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # MetadataTemplate definition for AspectType
+          # MetadataTemplate definition for an AspectType.
           # @!attribute [rw] index
           #   @return [::Integer]
           #     Optional. Index is used to encode Template messages. The value of index
@@ -92,42 +91,54 @@ module Google
           # @!attribute [rw] type
           #   @return [::String]
           #     Required. The datatype of this field. The following values are supported:
-          #     Primitive types (string, integer, boolean, double, datetime); datetime
-          #     must be of the format RFC3339 UTC "Zulu" (Examples:
-          #     "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"). Complex
-          #     types (enum, array, map, record).
+          #
+          #     Primitive types:
+          #
+          #     * string
+          #     * integer
+          #     * boolean
+          #     * double
+          #     * datetime. Must be of the format RFC3339 UTC "Zulu" (Examples:
+          #     "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z").
+          #
+          #     Complex types:
+          #
+          #     * enum
+          #     * array
+          #     * map
+          #     * record
           # @!attribute [rw] record_fields
           #   @return [::Array<::Google::Cloud::Dataplex::V1::AspectType::MetadataTemplate>]
-          #     Optional. Field definition, needs to be specified if the type is record.
-          #     Defines the nested fields.
+          #     Optional. Field definition. You must specify it if the type is record. It
+          #     defines the nested fields.
           # @!attribute [rw] enum_values
           #   @return [::Array<::Google::Cloud::Dataplex::V1::AspectType::MetadataTemplate::EnumValue>]
-          #     Optional. The list of values for an enum type. Needs to be defined if the
+          #     Optional. The list of values for an enum type. You must define it if the
           #     type is enum.
           # @!attribute [rw] map_items
           #   @return [::Google::Cloud::Dataplex::V1::AspectType::MetadataTemplate]
-          #     Optional. map_items needs to be set if the type is map. map_items can
-          #     refer to a primitive field or a complex (record only) field. To specify a
-          #     primitive field, just name and type needs to be set in the nested
+          #     Optional. If the type is map, set map_items. map_items can refer to a
+          #     primitive field or a complex (record only) field. To specify a primitive
+          #     field, you only need to set name and type in the nested
           #     MetadataTemplate. The recommended value for the name field is item, as
-          #     this is not used in the actual payload.
+          #     this isn't used in the actual payload.
           # @!attribute [rw] array_items
           #   @return [::Google::Cloud::Dataplex::V1::AspectType::MetadataTemplate]
-          #     Optional. array_items needs to be set if the type is array. array_items
-          #     can refer to a primitive field or a complex (record only) field. To
-          #     specify a primitive field, just name and type needs to be set in the
-          #     nested MetadataTemplate. The recommended value for the name field is
-          #     item, as this is not used in the actual payload.
+          #     Optional. If the type is array, set array_items. array_items can refer
+          #     to a primitive field or a complex (record only) field. To specify a
+          #     primitive field, you only need to set name and type in the nested
+          #     MetadataTemplate. The recommended value for the name field is item, as
+          #     this isn't used in the actual payload.
           # @!attribute [rw] type_id
           #   @return [::String]
-          #     Optional. Id can be used if this definition of the field needs to be
-          #     reused later. Id needs to be unique across the entire template. Id can
-          #     only be specified if the field type is record.
+          #     Optional. You can use type id if this definition of the field needs to be
+          #     reused later. The type id must be unique across the entire template. You
+          #     can only specify it if the field type is record.
           # @!attribute [rw] type_ref
           #   @return [::String]
-          #     Optional. A reference to another field definition (instead of an inline
+          #     Optional. A reference to another field definition (not an inline
           #     definition). The value must be equal to the value of an id field defined
-          #     elsewhere in the MetadataTemplate. Only fields with type as record can
+          #     elsewhere in the MetadataTemplate. Only fields with record type can
           #     refer to other fields.
           # @!attribute [rw] constraints
           #   @return [::Google::Cloud::Dataplex::V1::AspectType::MetadataTemplate::Constraints]
@@ -139,57 +150,59 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
 
-            # Definition of Enumvalue (to be used by enum fields)
+            # Definition of Enumvalue, to be used for enum fields.
             # @!attribute [rw] index
             #   @return [::Integer]
-            #     Required. Index for the enum. Cannot be modified.
+            #     Required. Index for the enum value. It can't be modified.
             # @!attribute [rw] name
             #   @return [::String]
             #     Required. Name of the enumvalue. This is the actual value that the
-            #     aspect will contain.
+            #     aspect can contain.
             # @!attribute [rw] deprecated
             #   @return [::String]
-            #     Optional. Optional deprecation message to be set if an enum value needs
-            #     to be deprecated.
+            #     Optional. You can set this message if you need to deprecate an enum
+            #     value.
             class EnumValue
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
-            # Definition of the constraints of a field
+            # Definition of the constraints of a field.
             # @!attribute [rw] required
             #   @return [::Boolean]
-            #     Optional. Marks this as an optional/required field.
+            #     Optional. Marks this field as optional or required.
             class Constraints
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
-            # Definition of the annotations of a field
+            # Definition of the annotations of a field.
             # @!attribute [rw] deprecated
             #   @return [::String]
-            #     Optional. Marks a field as deprecated, a deprecation message can be
-            #     included.
+            #     Optional. Marks a field as deprecated. You can include a deprecation
+            #     message.
             # @!attribute [rw] display_name
             #   @return [::String]
-            #     Optional. Specify a displayname for a field.
+            #     Optional. Display name for a field.
             # @!attribute [rw] description
             #   @return [::String]
-            #     Optional. Specify a description for a field
+            #     Optional. Description for a field.
             # @!attribute [rw] display_order
             #   @return [::Integer]
-            #     Optional. Specify a display order for a field. Display order can be
-            #     used to reorder where a field is rendered
+            #     Optional. Display order for a field. You can use this to reorder where
+            #     a field is rendered.
             # @!attribute [rw] string_type
             #   @return [::String]
-            #     Optional. String Type annotations can be used to specify special
-            #     meaning to string fields. The following values are supported: richText:
-            #     The field must be interpreted as a rich text field. url: A fully
-            #     qualified url link. resource: A service qualified resource reference.
+            #     Optional. You can use String Type annotations to specify special
+            #     meaning to string fields. The following values are supported:
+            #
+            #     * richText: The field must be interpreted as a rich text field.
+            #     * url: A fully qualified URL link.
+            #     * resource: A service qualified resource reference.
             # @!attribute [rw] string_values
             #   @return [::Array<::String>]
-            #     Optional. Suggested hints for string fields. These can be used to
-            #     suggest values to users, through an UI for example.
+            #     Optional. Suggested hints for string fields. You can use them to
+            #     suggest values to users through console.
             class Annotations
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -209,13 +222,13 @@ module Google
         # An Entry Group represents a logical grouping of one or more Entries.
         # @!attribute [r] name
         #   @return [::String]
-        #     Output only. The relative resource name of the EntryGroup, of the form:
-        #     projects/\\{project_number}/locations/\\{location_id}/entryGroups/\\{entry_group_id}.
+        #     Output only. The relative resource name of the EntryGroup, in the format
+        #     projects/\\{project_id_or_number}/locations/\\{location_id}/entryGroups/\\{entry_group_id}.
         # @!attribute [r] uid
         #   @return [::String]
-        #     Output only. System generated globally unique ID for the EntryGroup. This
-        #     ID will be different if the EntryGroup is deleted and re-created with the
-        #     same name.
+        #     Output only. System generated globally unique ID for the EntryGroup. If you
+        #     delete and recreate the EntryGroup with the same name, this ID will be
+        #     different.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Output only. The time when the EntryGroup was created.
@@ -233,9 +246,9 @@ module Google
         #     Optional. User-defined labels for the EntryGroup.
         # @!attribute [rw] etag
         #   @return [::String]
-        #     This checksum is computed by the server based on the value of other
-        #     fields, and may be sent on update and delete requests to ensure the
-        #     client has an up-to-date value before proceeding.
+        #     This checksum is computed by the service, and might be sent on update and
+        #     delete requests to ensure the client has an up-to-date value before
+        #     proceeding.
         # @!attribute [r] transfer_status
         #   @return [::Google::Cloud::Dataplex::V1::TransferStatus]
         #     Output only. Denotes the transfer status of the Entry Group. It is
@@ -281,12 +294,12 @@ module Google
         #     Optional. User-defined labels for the EntryType.
         # @!attribute [rw] etag
         #   @return [::String]
-        #     Optional. This checksum is computed by the server based on the value of
-        #     other fields, and may be sent on update and delete requests to ensure the
-        #     client has an up-to-date value before proceeding.
+        #     Optional. This checksum is computed by the service, and might be sent on
+        #     update and delete requests to ensure the client has an up-to-date value
+        #     before proceeding.
         # @!attribute [rw] type_aliases
         #   @return [::Array<::String>]
-        #     Optional. Indicates the class this Entry Type belongs to, for example,
+        #     Optional. Indicates the classes this Entry Type belongs to, for example,
         #     TABLE, DATABASE, MODEL.
         # @!attribute [rw] platform
         #   @return [::String]
@@ -350,62 +363,72 @@ module Google
         # @!attribute [rw] data
         #   @return [::Google::Protobuf::Struct]
         #     Required. The content of the aspect, according to its aspect type schema.
-        #     This will replace `content`.
         #     The maximum size of the field is 120KB (encoded as UTF-8).
         # @!attribute [rw] aspect_source
         #   @return [::Google::Cloud::Dataplex::V1::AspectSource]
+        #     Optional. Information related to the source system of the aspect.
         class Aspect
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # AspectSource contains source system related information for the
-        # aspect.
+        # Information related to the source system of the aspect.
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The create time of the aspect in the source system.
+        #     The time the aspect was created in the source system.
         # @!attribute [rw] update_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The update time of the aspect in the source system.
+        #     The time the aspect was last updated in the source system.
+        # @!attribute [rw] data_version
+        #   @return [::String]
+        #     The version of the data format used to produce this data. This field is
+        #     used to indicated when the underlying data format changes (e.g., schema
+        #     modifications, changes to the source URL format definition, etc).
         class AspectSource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # An entry is a representation of a data asset which can be described by
+        # An entry is a representation of a data resource that can be described by
         # various metadata.
         # @!attribute [rw] name
         #   @return [::String]
-        #     Identifier. The relative resource name of the Entry, of the form:
-        #     projects/\\{project}/locations/\\{location}/entryGroups/\\{entry_group}/entries/\\{entry}.
+        #     Identifier. The relative resource name of the entry, in the format
+        #     `projects/{project_id_or_number}/locations/{location_id}/entryGroups/{entry_group_id}/entries/{entry_id}`.
         # @!attribute [rw] entry_type
         #   @return [::String]
-        #     Required. Immutable. The resource name of the EntryType used to create this
-        #     Entry.
+        #     Required. Immutable. The relative resource name of the entry type that was
+        #     used to create this entry, in the format
+        #     `projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}`.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The time when the Entry was created.
+        #     Output only. The time when the entry was created in Dataplex.
         # @!attribute [r] update_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The time when the Entry was last updated.
+        #     Output only. The time when the entry was last updated in Dataplex.
         # @!attribute [rw] aspects
         #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::Dataplex::V1::Aspect}]
-        #     Optional. The Aspects attached to the Entry.
-        #     The format for the key can be one of the following:
-        #     1. \\{projectId}.\\{locationId}.\\{aspectTypeId} (if the aspect is attached
-        #     directly to the entry)
-        #     2. \\{projectId}.\\{locationId}.\\{aspectTypeId}@\\{path} (if the aspect is
-        #     attached to an entry's path)
+        #     Optional. The aspects that are attached to the entry. Depending on how the
+        #     aspect is attached to the entry, the format of the aspect key can be one of
+        #     the following:
+        #
+        #     * If the aspect is attached directly to the entry:
+        #     `{project_id_or_number}.{location_id}.{aspect_type_id}`
+        #     * If the aspect is attached to an entry's path:
+        #     `{project_id_or_number}.{location_id}.{aspect_type_id}@{path}`
         # @!attribute [rw] parent_entry
         #   @return [::String]
         #     Optional. Immutable. The resource name of the parent entry.
         # @!attribute [rw] fully_qualified_name
         #   @return [::String]
-        #     Optional. A name for the entry that can reference it in an external system.
+        #     Optional. A name for the entry that can be referenced by an external
+        #     system. For more information, see [Fully qualified
+        #     names](https://cloud.google.com/data-catalog/docs/fully-qualified-names).
         #     The maximum size of the field is 4000 characters.
         # @!attribute [rw] entry_source
         #   @return [::Google::Cloud::Dataplex::V1::EntrySource]
-        #     Optional. Source system related information for an entry.
+        #     Optional. Information related to the source system of the data resource
+        #     that is represented by the entry.
         class Entry
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -420,53 +443,57 @@ module Google
           end
         end
 
-        # EntrySource contains source system related information for the
-        # entry.
+        # Information related to the source system of the data resource that is
+        # represented by the entry.
         # @!attribute [rw] resource
         #   @return [::String]
         #     The name of the resource in the source system.
-        #     The maximum size of the field is 4000 characters.
+        #     Maximum length is 4,000 characters.
         # @!attribute [rw] system
         #   @return [::String]
         #     The name of the source system.
-        #     The maximum size of the field is 64 characters.
+        #     Maximum length is 64 characters.
         # @!attribute [rw] platform
         #   @return [::String]
         #     The platform containing the source system.
-        #     The maximum size of the field is 64 characters.
+        #     Maximum length is 64 characters.
         # @!attribute [rw] display_name
         #   @return [::String]
-        #     User friendly display name.
-        #     The maximum size of the field is 500 characters.
+        #     A user-friendly display name.
+        #     Maximum length is 500 characters.
         # @!attribute [rw] description
         #   @return [::String]
-        #     Description of the Entry.
-        #     The maximum size of the field is 2000 characters.
+        #     A description of the data resource.
+        #     Maximum length is 2,000 characters.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     User-defined labels.
         #     The maximum size of keys and values is 128 characters each.
         # @!attribute [rw] ancestors
         #   @return [::Array<::Google::Cloud::Dataplex::V1::EntrySource::Ancestor>]
-        #     Immutable. The ancestors of the Entry in the source system.
+        #     Immutable. The entries representing the ancestors of the data resource in
+        #     the source system.
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The create time of the resource in the source system.
+        #     The time when the resource was created in the source system.
         # @!attribute [rw] update_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The update time of the resource in the source system.
+        #     The time when the resource was last updated in the source system. If the
+        #     entry exists in the system and its `EntrySource` has `update_time`
+        #     populated, further updates to the `EntrySource` of the entry must provide
+        #     incremental updates to its `update_time`.
         # @!attribute [r] location
         #   @return [::String]
-        #     Output only. Location of the resource in the source system. Entry will be
-        #     searchable by this location. By default, this should match the location of
-        #     the EntryGroup containing this entry. A different value allows capturing
-        #     source location for data external to GCP.
+        #     Output only. Location of the resource in the source system. You can search
+        #     the entry by this location. By default, this should match the location of
+        #     the entry group containing this entry. A different value allows capturing
+        #     the source location for data external to Google Cloud.
         class EntrySource
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
-          # Ancestor contains information about individual items in the hierarchy of
-          # an Entry.
+          # Information about individual items in the hierarchy that is associated with
+          # the data resource.
           # @!attribute [rw] name
           #   @return [::String]
           #     Optional. The name of the ancestor resource.
@@ -488,7 +515,7 @@ module Google
           end
         end
 
-        # Create EntryGroup Request
+        # Create EntryGroup Request.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the entryGroup, of the form:
@@ -499,33 +526,33 @@ module Google
         #     Required. EntryGroup identifier.
         # @!attribute [rw] entry_group
         #   @return [::Google::Cloud::Dataplex::V1::EntryGroup]
-        #     Required. EntryGroup Resource
+        #     Required. EntryGroup Resource.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the request, but do not perform mutations.
-        #     The default is false.
+        #     Optional. The service validates the request without performing any
+        #     mutations. The default is false.
         class CreateEntryGroupRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Update EntryGroup Request
+        # Update EntryGroup Request.
         # @!attribute [rw] entry_group
         #   @return [::Google::Cloud::Dataplex::V1::EntryGroup]
-        #     Required. EntryGroup Resource
+        #     Required. EntryGroup Resource.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Required. Mask of fields to update.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the request, but do not perform mutations.
-        #     The default is false.
+        #     Optional. The service validates the request, without performing any
+        #     mutations. The default is false.
         class UpdateEntryGroupRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Delele EntryGroup Request
+        # Delete EntryGroup Request.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the EntryGroup:
@@ -533,7 +560,8 @@ module Google
         # @!attribute [rw] etag
         #   @return [::String]
         #     Optional. If the client provided etag value does not match the current etag
-        #     value, the DeleteEntryGroupRequest method returns an ABORTED error response
+        #     value, the DeleteEntryGroupRequest method returns an ABORTED error
+        #     response.
         class DeleteEntryGroupRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -544,19 +572,19 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the entryGroup location, of the form:
         #     `projects/{project_number}/locations/{location_id}`
-        #     where `location_id` refers to a GCP region.
+        #     where `location_id` refers to a Google Cloud region.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of EntryGroups to return. The service may return
-        #     fewer than this value. If unspecified, at most 10 EntryGroups will be
-        #     returned. The maximum value is 1000; values above 1000 will be coerced to
-        #     1000.
+        #     fewer than this value. If unspecified, the service returns at most 10
+        #     EntryGroups. The maximum value is 1000; values above 1000 will be coerced
+        #     to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. Page token received from a previous `ListEntryGroups` call.
         #     Provide this to retrieve the subsequent page. When paginating, all other
-        #     parameters provided to `ListEntryGroups` must match the call that provided
-        #     the page token.
+        #     parameters you provide to `ListEntryGroups` must match the call that
+        #     provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
         #     Optional. Filter request.
@@ -568,17 +596,17 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # List ListEntryGroups response.
+        # List entry groups response.
         # @!attribute [rw] entry_groups
         #   @return [::Array<::Google::Cloud::Dataplex::V1::EntryGroup>]
-        #     ListEntryGroups under the given parent location.
+        #     Entry groups under the given parent location.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     Token to retrieve the next page of results, or empty if there are no more
         #     results in the list.
         # @!attribute [rw] unreachable_locations
         #   @return [::Array<::String>]
-        #     Locations that could not be reached.
+        #     Locations that the service couldn't reach.
         class ListEntryGroupsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -594,44 +622,44 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Create EntryType Request
+        # Create EntryType Request.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the EntryType, of the form:
         #     projects/\\{project_number}/locations/\\{location_id}
-        #     where `location_id` refers to a GCP region.
+        #     where `location_id` refers to a Google Cloud region.
         # @!attribute [rw] entry_type_id
         #   @return [::String]
         #     Required. EntryType identifier.
         # @!attribute [rw] entry_type
         #   @return [::Google::Cloud::Dataplex::V1::EntryType]
-        #     Required. EntryType Resource
+        #     Required. EntryType Resource.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the request, but do not perform mutations.
-        #     The default is false.
+        #     Optional. The service validates the request without performing any
+        #     mutations. The default is false.
         class CreateEntryTypeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Update EntryType Request
+        # Update EntryType Request.
         # @!attribute [rw] entry_type
         #   @return [::Google::Cloud::Dataplex::V1::EntryType]
-        #     Required. EntryType Resource
+        #     Required. EntryType Resource.
         # @!attribute [rw] update_mask
         #   @return [::Google::Protobuf::FieldMask]
         #     Required. Mask of fields to update.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the request, but do not perform mutations.
-        #     The default is false.
+        #     Optional. The service validates the request without performing any
+        #     mutations. The default is false.
         class UpdateEntryTypeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Delele EntryType Request
+        # Delele EntryType Request.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the EntryType:
@@ -639,7 +667,7 @@ module Google
         # @!attribute [rw] etag
         #   @return [::String]
         #     Optional. If the client provided etag value does not match the current etag
-        #     value, the DeleteEntryTypeRequest method returns an ABORTED error response
+        #     value, the DeleteEntryTypeRequest method returns an ABORTED error response.
         class DeleteEntryTypeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -650,54 +678,55 @@ module Google
         #   @return [::String]
         #     Required. The resource name of the EntryType location, of the form:
         #     `projects/{project_number}/locations/{location_id}`
-        #     where `location_id` refers to a GCP region.
+        #     where `location_id` refers to a Google Cloud region.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of EntryTypes to return. The service may return
-        #     fewer than this value. If unspecified, at most 10 EntryTypes will be
-        #     returned. The maximum value is 1000; values above 1000 will be coerced to
+        #     fewer than this value. If unspecified, the service returns at most 10
+        #     EntryTypes. The maximum value is 1000; values above 1000 will be coerced to
         #     1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. Page token received from a previous `ListEntryTypes` call.
         #     Provide this to retrieve the subsequent page. When paginating, all other
-        #     parameters provided to `ListEntryTypes` must match the call that provided
-        #     the page token.
+        #     parameters you provided to `ListEntryTypes` must match the call that
+        #     provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
         #     Optional. Filter request. Filters are case-sensitive.
-        #     The following formats are supported:
+        #     The service supports the following formats:
+        #
+        #     * labels.key1 = "value1"
+        #     * labels:key1
+        #     * name = "value"
         #
-        #     labels.key1 = "value1"
-        #     labels:key1
-        #     name = "value"
-        #     These restrictions can be coinjoined with AND, OR and NOT conjunctions.
+        #     These restrictions can be conjoined with AND, OR, and NOT conjunctions.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. Order by fields (`name` or `create_time`) for the result.
+        #     Optional. Orders the result by `name` or `create_time` fields.
         #     If not specified, the ordering is undefined.
         class ListEntryTypesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # List EntryTypes response
+        # List EntryTypes response.
         # @!attribute [rw] entry_types
         #   @return [::Array<::Google::Cloud::Dataplex::V1::EntryType>]
-        #     ListEntryTypes under the given parent location.
+        #     EntryTypes under the given parent location.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     Token to retrieve the next page of results, or empty if there are no more
         #     results in the list.
         # @!attribute [rw] unreachable_locations
         #   @return [::Array<::String>]
-        #     Locations that could not be reached.
+        #     Locations that the service couldn't reach.
         class ListEntryTypesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Get EntryType request
+        # Get EntryType request.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the EntryType:
@@ -707,22 +736,22 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Create AspectType Request
+        # Create AspectType Request.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the AspectType, of the form:
         #     projects/\\{project_number}/locations/\\{location_id}
-        #     where `location_id` refers to a GCP region.
+        #     where `location_id` refers to a Google Cloud region.
         # @!attribute [rw] aspect_type_id
         #   @return [::String]
         #     Required. AspectType identifier.
         # @!attribute [rw] aspect_type
         #   @return [::Google::Cloud::Dataplex::V1::AspectType]
-        #     Required. AspectType Resource
+        #     Required. AspectType Resource.
         # @!attribute [rw] validate_only
         #   @return [::Boolean]
-        #     Optional. Only validate the request, but do not perform mutations.
-        #     The default is false.
+        #     Optional. The service validates the request without performing any
+        #     mutations. The default is false.
         class CreateAspectTypeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -744,7 +773,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Delele AspectType Request
+        # Delele AspectType Request.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the AspectType:
@@ -752,65 +781,67 @@ module Google
         # @!attribute [rw] etag
         #   @return [::String]
         #     Optional. If the client provided etag value does not match the current etag
-        #     value, the DeleteAspectTypeRequest method returns an ABORTED error response
+        #     value, the DeleteAspectTypeRequest method returns an ABORTED error
+        #     response.
         class DeleteAspectTypeRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # List AspectTypes request
+        # List AspectTypes request.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the AspectType location, of the form:
         #     `projects/{project_number}/locations/{location_id}`
-        #     where `location_id` refers to a GCP region.
+        #     where `location_id` refers to a Google Cloud region.
         # @!attribute [rw] page_size
         #   @return [::Integer]
         #     Optional. Maximum number of AspectTypes to return. The service may return
-        #     fewer than this value. If unspecified, at most 10 AspectTypes will be
-        #     returned. The maximum value is 1000; values above 1000 will be coerced to
-        #     1000.
+        #     fewer than this value. If unspecified, the service returns at most 10
+        #     AspectTypes. The maximum value is 1000; values above 1000 will be coerced
+        #     to 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
         #     Optional. Page token received from a previous `ListAspectTypes` call.
         #     Provide this to retrieve the subsequent page. When paginating, all other
-        #     parameters provided to `ListAspectTypes` must match the call that provided
-        #     the page token.
+        #     parameters you provide to `ListAspectTypes` must match the call that
+        #     provided the page token.
         # @!attribute [rw] filter
         #   @return [::String]
         #     Optional. Filter request. Filters are case-sensitive.
-        #     The following formats are supported:
+        #     The service supports the following formats:
+        #
+        #     * labels.key1 = "value1"
+        #     * labels:key1
+        #     * name = "value"
         #
-        #     labels.key1 = "value1"
-        #     labels:key1
-        #     name = "value"
-        #     These restrictions can be coinjoined with AND, OR and NOT conjunctions.
+        #     These restrictions can be conjoined with AND, OR, and NOT conjunctions.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. Order by fields (`name` or `create_time`) for the result.
+        #     Optional. Orders the result by `name` or `create_time` fields.
         #     If not specified, the ordering is undefined.
         class ListAspectTypesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # List AspectTypes response
+        # List AspectTypes response.
         # @!attribute [rw] aspect_types
         #   @return [::Array<::Google::Cloud::Dataplex::V1::AspectType>]
-        #     ListAspectTypes under the given parent location.
+        #     AspectTypes under the given parent location.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     Token to retrieve the next page of results, or empty if there are no more
         #     results in the list.
         # @!attribute [rw] unreachable_locations
         #   @return [::Array<::String>]
-        #     Locations that could not be reached.
+        #     Locations that the service couldn't reach.
         class ListAspectTypesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Get AspectType request
+        # Get AspectType request.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the AspectType:
@@ -820,6 +851,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Create Entry request.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the parent Entry Group:
@@ -828,20 +860,21 @@ module Google
         #   @return [::String]
         #     Required. Entry identifier. It has to be unique within an Entry Group.
         #
-        #     Entries corresponding to Google Cloud resources use Entry ID format based
-        #     on Full Resource Names
-        #     (https://cloud.google.com/apis/design/resource_names#full_resource_name).
-        #     The format is a Full Resource Name of the resource without the
-        #     prefix double slashes in the API Service Name part of Full Resource Name.
-        #     This allows retrieval of entries using their associated resource name.
+        #     Entries corresponding to Google Cloud resources use an Entry ID format
+        #     based on [full resource
+        #     names](https://cloud.google.com/apis/design/resource_names#full_resource_name).
+        #     The format is a full resource name of the resource without the
+        #     prefix double slashes in the API service name part of the full resource
+        #     name. This allows retrieval of entries using their associated resource
+        #     name.
         #
-        #     For example if the Full Resource Name of a resource is
+        #     For example, if the full resource name of a resource is
         #     `//library.googleapis.com/shelves/shelf1/books/book2`,
         #     then the suggested entry_id is
         #     `library.googleapis.com/shelves/shelf1/books/book2`.
         #
         #     It is also suggested to follow the same convention for entries
-        #     corresponding to resources from other providers or systems than Google
+        #     corresponding to resources from providers or systems other than Google
         #     Cloud.
         #
         #     The maximum size of the field is 4000 characters.
@@ -853,6 +886,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Update Entry request.
         # @!attribute [rw] entry
         #   @return [::Google::Cloud::Dataplex::V1::Entry]
         #     Required. Entry resource.
@@ -861,36 +895,43 @@ module Google
         #     Optional. Mask of fields to update. To update Aspects, the update_mask must
         #     contain the value "aspects".
         #
-        #     If the update_mask is empty, all modifiable fields present in the request
-        #     will be updated.
+        #     If the update_mask is empty, the service will update all modifiable fields
+        #     present in the request.
         # @!attribute [rw] allow_missing
         #   @return [::Boolean]
-        #     Optional. If set to true and the entry does not exist, it will be created.
+        #     Optional. If set to true and the entry doesn't exist, the service will
+        #     create it.
         # @!attribute [rw] delete_missing_aspects
         #   @return [::Boolean]
-        #     Optional. If set to true and the aspect_keys specify aspect ranges, any
-        #     existing aspects from that range not provided in the request will be
-        #     deleted.
+        #     Optional. If set to true and the aspect_keys specify aspect ranges, the
+        #     service deletes any existing aspects from that range that weren't provided
+        #     in the request.
         # @!attribute [rw] aspect_keys
         #   @return [::Array<::String>]
-        #     Optional. The map keys of the Aspects which should be modified. Supports
-        #     the following syntaxes:
-        #     * <aspect_type_reference> - matches aspect on given type and empty path
-        #     * <aspect_type_reference>@path - matches aspect on given type and specified
-        #     path
-        #     * <aspect_type_reference>* - matches aspects on given type for all paths
-        #     * *@path - matches aspects of all types on the given path
+        #     Optional. The map keys of the Aspects which the service should modify. It
+        #     supports the following syntaxes:
         #
-        #     Existing aspects matching the syntax will not be removed unless
+        #     * `<aspect_type_reference>` - matches an aspect of the given type and empty
+        #     path.
+        #     * `<aspect_type_reference>@path` - matches an aspect of the given type and
+        #     specified path. For example, to attach an aspect to a field that is
+        #     specified by the `schema` aspect, the path should have the format
+        #     `Schema.<field_name>`.
+        #     * `<aspect_type_reference>*` - matches aspects of the given type for all
+        #     paths.
+        #     * `*@path` - matches aspects of all types on the given path.
+        #
+        #     The service will not remove existing aspects matching the syntax unless
         #     `delete_missing_aspects` is set to true.
         #
-        #     If this field is left empty, it will be treated as specifying exactly those
-        #     Aspects present in the request.
+        #     If this field is left empty, the service treats it as specifying
+        #     exactly those Aspects present in the request.
         class UpdateEntryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Delete Entry request.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Entry:
@@ -900,82 +941,101 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # List Entries request.
         # @!attribute [rw] parent
         #   @return [::String]
         #     Required. The resource name of the parent Entry Group:
         #     `projects/{project}/locations/{location}/entryGroups/{entry_group}`.
         # @!attribute [rw] page_size
         #   @return [::Integer]
+        #     Optional. Number of items to return per page. If there are remaining
+        #     results, the service returns a next_page_token. If unspecified, the service
+        #     returns at most 10 Entries. The maximum value is 100; values above 100 will
+        #     be coerced to 100.
         # @!attribute [rw] page_token
         #   @return [::String]
-        #     Optional. The pagination token returned by a previous request.
+        #     Optional. Page token received from a previous `ListEntries` call. Provide
+        #     this to retrieve the subsequent page.
         # @!attribute [rw] filter
         #   @return [::String]
-        #     Optional. A filter on the entries to return.
-        #     Filters are case-sensitive.
-        #     The request can be filtered by the following fields:
-        #     entry_type, entry_source.display_name.
-        #     The comparison operators are =, !=, <, >, <=, >= (strings are compared
-        #     according to lexical order)
-        #     The logical operators AND, OR, NOT can be used
-        #     in the filter. Wildcard "*" can be used, but for entry_type the full
-        #     project id or number needs to be provided. Example filter expressions:
-        #     "entry_source.display_name=AnExampleDisplayName"
-        #     "entry_type=projects/example-project/locations/global/entryTypes/example-entry_type"
-        #     "entry_type=projects/example-project/locations/us/entryTypes/a* OR
-        #      entry_type=projects/another-project/locations/*"
-        #     "NOT entry_source.display_name=AnotherExampleDisplayName"
+        #     Optional. A filter on the entries to return. Filters are case-sensitive.
+        #     You can filter the request by the following fields:
+        #
+        #     * entry_type
+        #     * entry_source.display_name
+        #
+        #     The comparison operators are =, !=, <, >, <=, >=. The service compares
+        #     strings according to lexical order.
+        #
+        #     You can use the logical operators AND, OR, NOT in the filter.
+        #
+        #     You can use Wildcard "*", but for entry_type you need to provide the
+        #     full project id or number.
+        #
+        #     Example filter expressions:
+        #
+        #     * "entry_source.display_name=AnExampleDisplayName"
+        #     * "entry_type=projects/example-project/locations/global/entryTypes/example-entry_type"
+        #     * "entry_type=projects/example-project/locations/us/entryTypes/a* OR
+        #     entry_type=projects/another-project/locations/*"
+        #     * "NOT entry_source.display_name=AnotherExampleDisplayName"
         class ListEntriesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # List Entries response.
         # @!attribute [rw] entries
         #   @return [::Array<::Google::Cloud::Dataplex::V1::Entry>]
-        #     The list of entries.
+        #     The list of entries under the given parent location.
         # @!attribute [rw] next_page_token
         #   @return [::String]
-        #     Pagination token.
+        #     Token to retrieve the next page of results, or empty if there are no more
+        #     results in the list.
         class ListEntriesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Get Entry request.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The resource name of the Entry:
         #     `projects/{project}/locations/{location}/entryGroups/{entry_group}/entries/{entry}`.
         # @!attribute [rw] view
         #   @return [::Google::Cloud::Dataplex::V1::EntryView]
-        #     Optional. View for controlling which parts of an entry are to be returned.
+        #     Optional. View to control which parts of an entry the service should
+        #     return.
         # @!attribute [rw] aspect_types
         #   @return [::Array<::String>]
         #     Optional. Limits the aspects returned to the provided aspect types.
-        #     Only works if the CUSTOM view is selected.
+        #     It only works for CUSTOM view.
         # @!attribute [rw] paths
         #   @return [::Array<::String>]
         #     Optional. Limits the aspects returned to those associated with the provided
-        #     paths within the Entry. Only works if the CUSTOM view is selected.
+        #     paths within the Entry. It only works for CUSTOM view.
         class GetEntryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Lookup Entry request using permissions in the source system.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. The project to which the request should be attributed in the
         #     following form: `projects/{project}/locations/{location}`.
         # @!attribute [rw] view
         #   @return [::Google::Cloud::Dataplex::V1::EntryView]
-        #     Optional. View for controlling which parts of an entry are to be returned.
+        #     Optional. View to control which parts of an entry the service should
+        #     return.
         # @!attribute [rw] aspect_types
         #   @return [::Array<::String>]
         #     Optional. Limits the aspects returned to the provided aspect types.
-        #     Only works if the CUSTOM view is selected.
+        #     It only works for CUSTOM view.
         # @!attribute [rw] paths
         #   @return [::Array<::String>]
         #     Optional. Limits the aspects returned to those associated with the provided
-        #     paths within the Entry. Only works if the CUSTOM view is selected.
+        #     paths within the Entry. It only works for CUSTOM view.
         # @!attribute [rw] entry
         #   @return [::String]
         #     Required. The resource name of the Entry:
@@ -994,18 +1054,22 @@ module Google
         #     Required. The query against which entries in scope should be matched.
         # @!attribute [rw] page_size
         #   @return [::Integer]
-        #     Optional. Pagination.
+        #     Optional. Number of results in the search page. If <=0, then defaults
+        #     to 10. Max limit for page_size is 1000. Throws an invalid argument for
+        #     page_size > 1000.
         # @!attribute [rw] page_token
         #   @return [::String]
+        #     Optional. Page token received from a previous `SearchEntries` call. Provide
+        #     this to retrieve the subsequent page.
         # @!attribute [rw] order_by
         #   @return [::String]
-        #     Optional. Ordering of the results. Supported options to be added later.
+        #     Optional. Specifies the ordering of results.
         # @!attribute [rw] scope
         #   @return [::String]
-        #     Optional. The scope under which the search should be operating. Should
-        #     either be organizations/<org_id> or projects/<project_ref>. If left
-        #     unspecified, it will default to the organization where the project provided
-        #     in `name` is located.
+        #     Optional. The scope under which the search should be operating. It must
+        #     either be `organizations/<org_id>` or `projects/<project_ref>`. If it is
+        #     unspecified, it defaults to the organization where the project provided in
+        #     `name` is located.
         class SearchEntriesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1044,20 +1108,432 @@ module Google
         #     The results matching the search query.
         # @!attribute [rw] total_size
         #   @return [::Integer]
-        #     The estimated total number of matching entries. Not guaranteed to be
-        #     accurate.
+        #     The estimated total number of matching entries. This number isn't
+        #     guaranteed to be accurate.
         # @!attribute [rw] next_page_token
         #   @return [::String]
-        #     Pagination token.
+        #     Token to retrieve the next page of results, or empty if there are no more
+        #     results in the list.
         # @!attribute [rw] unreachable
         #   @return [::Array<::String>]
-        #     Unreachable locations. Search results don't include data from those
-        #     locations.
+        #     Locations that the service couldn't reach. Search results don't include
+        #     data from these locations.
         class SearchEntriesResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # An object that describes the values that you want to set for an entry and its
+        # attached aspects when you import metadata. Used when you run a metadata
+        # import job. See
+        # {::Google::Cloud::Dataplex::V1::CatalogService::Client#create_metadata_job CreateMetadataJob}.
+        #
+        # You provide a collection of import items in a metadata import file. For more
+        # information about how to create a metadata import file, see [Metadata import
+        # file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
+        # @!attribute [rw] entry
+        #   @return [::Google::Cloud::Dataplex::V1::Entry]
+        #     Information about an entry and its attached aspects.
+        # @!attribute [rw] update_mask
+        #   @return [::Google::Protobuf::FieldMask]
+        #     The fields to update, in paths that are relative to the `Entry` resource.
+        #     Separate each field with a comma.
+        #
+        #     In `FULL` entry sync mode, Dataplex includes the paths of all of the fields
+        #     for an entry that can be modified, including aspects. This means that
+        #     Dataplex replaces the existing entry with the entry in the metadata import
+        #     file. All modifiable fields are updated, regardless of the fields that are
+        #     listed in the update mask, and regardless of whether a field is present
+        #     in the `entry` object.
+        #
+        #
+        #     The `update_mask` field is ignored when an entry is created or re-created.
+        #
+        #     Dataplex also determines which entries and aspects to modify by comparing
+        #     the values and timestamps that you provide in the metadata import file with
+        #     the values and timestamps that exist in your project. For more information,
+        #     see [Comparison
+        #     logic](https://cloud.google.com/dataplex/docs/import-metadata#data-modification-logic).
+        # @!attribute [rw] aspect_keys
+        #   @return [::Array<::String>]
+        #     The aspects to modify. Supports the following syntaxes:
+        #
+        #     * `{aspect_type_reference}`: matches aspects that belong to the specified
+        #     aspect type and are attached directly to the entry.
+        #     * `{aspect_type_reference}@{path}`: matches aspects that belong to the
+        #     specified aspect type and path.
+        #     * `{aspect_type_reference}@*`: matches aspects that belong to the specified
+        #     aspect type for all paths.
+        #
+        #     Replace `{aspect_type_reference}` with a reference to the aspect type, in
+        #     the format
+        #     `{project_id_or_number}.{location_id}.{aspect_type_id}`.
+        #
+        #     If you leave this field empty, it is treated as specifying exactly those
+        #     aspects that are present within the specified entry.
+        #
+        #     In `FULL` entry sync mode, Dataplex implicitly adds the keys for all of the
+        #     required aspects of an entry.
+        class ImportItem
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Create metadata job request.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the parent location, in the format
+        #     `projects/{project_id_or_number}/locations/{location_id}`
+        # @!attribute [rw] metadata_job
+        #   @return [::Google::Cloud::Dataplex::V1::MetadataJob]
+        #     Required. The metadata job resource.
+        # @!attribute [rw] metadata_job_id
+        #   @return [::String]
+        #     Optional. The metadata job ID. If not provided, a unique ID is generated
+        #     with the prefix `metadata-job-`.
+        # @!attribute [rw] validate_only
+        #   @return [::Boolean]
+        #     Optional. The service validates the request without performing any
+        #     mutations. The default is false.
+        class CreateMetadataJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Get metadata job request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the metadata job, in the format
+        #     `projects/{project_id_or_number}/locations/{location_id}/metadataJobs/{metadata_job_id}`.
+        class GetMetadataJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # List metadata jobs request.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The resource name of the parent location, in the format
+        #     `projects/{project_id_or_number}/locations/{location_id}`
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of metadata jobs to return. The service might
+        #     return fewer jobs than this value. If unspecified, at most 10 jobs are
+        #     returned. The maximum value is 1,000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. The page token received from a previous `ListMetadataJobs` call.
+        #     Provide this token to retrieve the subsequent page of results. When
+        #     paginating, all other parameters that are provided to the
+        #     `ListMetadataJobs` request must match the call that provided the page
+        #     token.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. Filter request. Filters are case-sensitive.
+        #     The service supports the following formats:
+        #
+        #     * `labels.key1 = "value1"`
+        #     * `labels:key1`
+        #     * `name = "value"`
+        #
+        #     You can combine filters with `AND`, `OR`, and `NOT` operators.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. The field to sort the results by, either `name` or `create_time`.
+        #     If not specified, the ordering is undefined.
+        class ListMetadataJobsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # List metadata jobs response.
+        # @!attribute [rw] metadata_jobs
+        #   @return [::Array<::Google::Cloud::Dataplex::V1::MetadataJob>]
+        #     Metadata jobs under the specified parent location.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token to retrieve the next page of results. If there are no more results
+        #     in the list, the value is empty.
+        # @!attribute [rw] unreachable_locations
+        #   @return [::Array<::String>]
+        #     Locations that the service couldn't reach.
+        class ListMetadataJobsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Cancel metadata job request.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The resource name of the job, in the format
+        #     `projects/{project_id_or_number}/locations/{location_id}/metadataJobs/{metadata_job_id}`
+        class CancelMetadataJobRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A metadata job resource.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Identifier. The name of the resource that the configuration is
+        #     applied to, in the format
+        #     `projects/{project_number}/locations/{location_id}/metadataJobs/{metadata_job_id}`.
+        # @!attribute [r] uid
+        #   @return [::String]
+        #     Output only. A system-generated, globally unique ID for the metadata job.
+        #     If the metadata job is deleted and then re-created with the same name, this
+        #     ID is different.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the metadata job was created.
+        # @!attribute [r] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the metadata job was updated.
+        # @!attribute [rw] labels
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. User-defined labels.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Type]
+        #     Required. Metadata job type.
+        # @!attribute [rw] import_spec
+        #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec]
+        #     Import job specification.
+        # @!attribute [r] import_result
+        #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobResult]
+        #     Output only. Import job result.
+        # @!attribute [r] status
+        #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status]
+        #     Output only. Metadata job status.
+        class MetadataJob
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Results from a metadata import job.
+          # @!attribute [r] deleted_entries
+          #   @return [::Integer]
+          #     Output only. The total number of entries that were deleted.
+          # @!attribute [r] updated_entries
+          #   @return [::Integer]
+          #     Output only. The total number of entries that were updated.
+          # @!attribute [r] created_entries
+          #   @return [::Integer]
+          #     Output only. The total number of entries that were created.
+          # @!attribute [r] unchanged_entries
+          #   @return [::Integer]
+          #     Output only. The total number of entries that were unchanged.
+          # @!attribute [r] recreated_entries
+          #   @return [::Integer]
+          #     Output only. The total number of entries that were recreated.
+          # @!attribute [r] update_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. The time when the status was updated.
+          class ImportJobResult
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Job specification for a metadata import job
+          # @!attribute [rw] source_storage_uri
+          #   @return [::String]
+          #     Optional. The URI of a Cloud Storage bucket or folder (beginning with
+          #     `gs://` and ending with `/`) that contains the metadata import files for
+          #     this job.
+          #
+          #     A metadata import file defines the values to set for each of the entries
+          #     and aspects in a metadata job. For more information about how to create a
+          #     metadata import file and the file requirements, see [Metadata import
+          #     file](https://cloud.google.com/dataplex/docs/import-metadata#metadata-import-file).
+          #
+          #     You can provide multiple metadata import files in the same metadata job.
+          #     The bucket or folder must contain at least one metadata import file, in
+          #     JSON Lines format (either `.json` or `.jsonl` file extension).
+          #
+          #     In `FULL` entry sync mode, don't save the metadata import file in a
+          #     folder named `SOURCE_STORAGE_URI/deletions/`.
+          #
+          #     **Caution**: If the metadata import file contains no data, all entries
+          #     and aspects that belong to the job's scope are deleted.
+          # @!attribute [rw] source_create_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Optional. The time when the process that created the metadata import
+          #     files began.
+          # @!attribute [rw] scope
+          #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::ImportJobScope]
+          #     Required. A boundary on the scope of impact that the metadata import job
+          #     can have.
+          # @!attribute [rw] entry_sync_mode
+          #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
+          #     Required. The sync mode for entries.
+          #     Only `FULL` mode is supported for entries. All entries in the job's scope
+          #     are modified. If an entry exists in Dataplex but isn't included in the
+          #     metadata import file, the entry is deleted when you run the metadata job.
+          # @!attribute [rw] aspect_sync_mode
+          #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::SyncMode]
+          #     Required. The sync mode for aspects.
+          #     Only `INCREMENTAL` mode is supported for aspects. An aspect is modified
+          #     only if the metadata import file includes a reference to the aspect in
+          #     the `update_mask` field and the `aspect_keys` field.
+          # @!attribute [rw] log_level
+          #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::ImportJobSpec::LogLevel]
+          #     Optional. The level of logs to write to Cloud Logging for this job.
+          #
+          #     Debug-level logs provide highly-detailed information for
+          #     troubleshooting, but their increased verbosity could incur [additional
+          #     costs](https://cloud.google.com/stackdriver/pricing) that might not be
+          #     merited for all jobs.
+          #
+          #     If unspecified, defaults to `INFO`.
+          class ImportJobSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # A boundary on the scope of impact that the metadata import job can have.
+            # @!attribute [rw] entry_groups
+            #   @return [::Array<::String>]
+            #     Required. The entry group that is in scope for the import job,
+            #     specified as a relative resource name in the format
+            #     `projects/{project_number_or_id}/locations/{location_id}/entryGroups/{entry_group_id}`.
+            #     Only entries that belong to the specified entry group are affected by
+            #     the job.
+            #
+            #     Must contain exactly one element. The entry group and the job
+            #     must be in the same location.
+            # @!attribute [rw] entry_types
+            #   @return [::Array<::String>]
+            #     Required. The entry types that are in scope for the import job,
+            #     specified as relative resource names in the format
+            #     `projects/{project_number_or_id}/locations/{location_id}/entryTypes/{entry_type_id}`.
+            #     The job modifies only the entries that belong to these entry types.
+            #
+            #     If the metadata import file attempts to modify an entry whose type
+            #     isn't included in this list, the import job is halted before modifying
+            #     any entries or aspects.
+            #
+            #     The location of an entry type must either match the location of the
+            #     job, or the entry type must be global.
+            # @!attribute [rw] aspect_types
+            #   @return [::Array<::String>]
+            #     Optional. The aspect types that are in scope for the import job,
+            #     specified as relative resource names in the format
+            #     `projects/{project_number_or_id}/locations/{location_id}/aspectTypes/{aspect_type_id}`.
+            #     The job modifies only the aspects that belong to these aspect types.
+            #
+            #     If the metadata import file attempts to modify an aspect whose type
+            #     isn't included in this list, the import job is halted before modifying
+            #     any entries or aspects.
+            #
+            #     The location of an aspect type must either match the location of the
+            #     job, or the aspect type must be global.
+            class ImportJobScope
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Specifies how the entries and aspects in a metadata job are updated.
+            module SyncMode
+              # Sync mode unspecified.
+              SYNC_MODE_UNSPECIFIED = 0
+
+              # All resources in the job's scope are modified. If a resource exists in
+              # Dataplex but isn't included in the metadata import file, the resource
+              # is deleted when you run the metadata job. Use this mode to perform a
+              # full sync of the set of entries in the job scope.
+              FULL = 1
+
+              # Only the entries and aspects that are explicitly included in the
+              # metadata import file are modified. Use this mode to modify a subset of
+              # resources while leaving unreferenced resources unchanged.
+              INCREMENTAL = 2
+            end
+
+            # The level of logs to write to Cloud Logging for this job.
+            module LogLevel
+              # Log level unspecified.
+              LOG_LEVEL_UNSPECIFIED = 0
+
+              # Debug-level logging. Captures detailed logs for each import item. Use
+              # debug-level logging to troubleshoot issues with specific import items.
+              # For example, use debug-level logging to identify resources that are
+              # missing from the job scope, entries or aspects that don't conform to
+              # the associated entry type or aspect type, or other misconfigurations
+              # with the metadata import file.
+              #
+              # Depending on the size of your metadata job and the number of logs that
+              # are generated, debug-level logging might incur
+              # [additional costs](https://cloud.google.com/stackdriver/pricing).
+              DEBUG = 1
+
+              # Info-level logging. Captures logs at the overall job level. Includes
+              # aggregate logs about import items, but doesn't specify which import
+              # item has an error.
+              INFO = 2
+            end
+          end
+
+          # Metadata job status.
+          # @!attribute [r] state
+          #   @return [::Google::Cloud::Dataplex::V1::MetadataJob::Status::State]
+          #     Output only. State of the metadata job.
+          # @!attribute [r] message
+          #   @return [::String]
+          #     Output only. Message relating to the progression of a metadata job.
+          # @!attribute [r] completion_percent
+          #   @return [::Integer]
+          #     Output only. Progress tracking.
+          # @!attribute [r] update_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Output only. The time when the status was updated.
+          class Status
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # State of a metadata job.
+            module State
+              # State unspecified.
+              STATE_UNSPECIFIED = 0
+
+              # The job is queued.
+              QUEUED = 1
+
+              # The job is running.
+              RUNNING = 2
+
+              # The job is being canceled.
+              CANCELING = 3
+
+              # The job is canceled.
+              CANCELED = 4
+
+              # The job succeeded.
+              SUCCEEDED = 5
+
+              # The job failed.
+              FAILED = 6
+
+              # The job completed with some errors.
+              SUCCEEDED_WITH_ERRORS = 7
+            end
+          end
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class LabelsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Metadata job type.
+          module Type
+            # Unspecified.
+            TYPE_UNSPECIFIED = 0
+
+            # Import job.
+            IMPORT = 1
+          end
+        end
+
         # View for controlling which parts of an entry are to be returned.
         module EntryView
           # Unspecified EntryView. Defaults to FULL.
@@ -1071,10 +1547,10 @@ module Google
           FULL = 2
 
           # Returns aspects matching custom fields in GetEntryRequest. If the number of
-          # aspects would exceed 100, the first 100 will be returned.
+          # aspects exceeds 100, the first 100 will be returned.
           CUSTOM = 3
 
-          # Returns all aspects. If the number of aspects would exceed 100, the first
+          # Returns all aspects. If the number of aspects exceeds 100, the first
           # 100 will be returned.
           ALL = 4
         end