google-apis-datacatalog_v1 0.29.0 → 0.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 714c2e8695a6d4f1070deb8b2c369b9946722d36be8d646d56d97840f8af0450
-  data.tar.gz: a0053d03ac5735377268a11b559696a75295b50d1ac256971af35228436468f7
+  metadata.gz: 8d6df4262f5ba1fe6a8ade14a5fb9c8d19ee81e30db4362ab11f758b486c94b2
+  data.tar.gz: e5a6bf6240c58ef7c1a08d3b53639090669da86e16b37ab8c80b55dc59c1b2b8
 SHA512:
-  metadata.gz: 79c20516ffa887b41ad1913b3895587df0d4cb6b8c295788718c7d1f48edbacae2e6985a54e688520bfc71da66dd80167894d387e9dd34dfdf720b5c5b0f92f3
-  data.tar.gz: 718ae0073590dd3487a611e3446e1c5e9582ca066ac51c8e5b610dbc85e4c859203b851367e74545342eba7fc84e6571297f2a2bae6ada088d16a716273b5736
+  metadata.gz: 589b3914509f04172360abac8a942f4985977fdd6d0e76803fe87ec0533fa3f74a8344eefd9434fc4275a07eb034819c325ab00ba05f77ba02934a1a6365dede
+  data.tar.gz: 047c43353576d146461918c039c527e760d151674cf7842820f3e1605e61d88a23092663256db16c79f6ffdf75c3f881cf6ba82a9f7c986d49847d0eee069b13

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-datacatalog_v1
 
+### v0.31.0 (2023-02-12)
+
+* Regenerated from discovery document revision 20230207
+
+### v0.30.0 (2023-02-05)
+
+* Regenerated from discovery document revision 20230127
+
 ### v0.29.0 (2023-01-22)
 
 * Regenerated from discovery document revision 20230117

data/lib/google/apis/datacatalog_v1/classes.rb

@@ -60,22 +60,22 @@ module Google
         # kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-
         # project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:`emailid``: An
         # email address that represents a Google group. For example, `admins@example.com`
-        # . * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # identifier) representing a user that has been recently deleted. For example, `
-        # alice@example.com?uid=123456789012345678901`. If the user is recovered, this
-        # value reverts to `user:`emailid`` and the recovered user retains the role in
-        # the binding. * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email
-        # address (plus unique identifier) representing a service account that has been
-        # recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=
+        # . * `domain:`domain``: The G Suite domain (primary) that represents all the
+        # users of that domain. For example, `google.com` or `example.com`. * `deleted:
+        # user:`emailid`?uid=`uniqueid``: An email address (plus unique identifier)
+        # representing a user that has been recently deleted. For example, `alice@
+        # example.com?uid=123456789012345678901`. If the user is recovered, this value
+        # reverts to `user:`emailid`` and the recovered user retains the role in the
+        # binding. * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address
+        # (plus unique identifier) representing a service account that has been recently
+        # deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=
         # 123456789012345678901`. If the service account is undeleted, this value
         # reverts to `serviceAccount:`emailid`` and the undeleted service account
         # retains the role in the binding. * `deleted:group:`emailid`?uid=`uniqueid``:
         # An email address (plus unique identifier) representing a Google group that has
         # been recently deleted. For example, `admins@example.com?uid=
         # 123456789012345678901`. If the group is recovered, this value reverts to `
-        # group:`emailid`` and the recovered group retains the role in the binding. * `
-        # domain:`domain``: The G Suite domain (primary) that represents all the users
-        # of that domain. For example, `google.com` or `example.com`.
+        # group:`emailid`` and the recovered group retains the role in the binding.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
@@ -1885,6 +1885,98 @@ module Google
         end
       end
       
+      # Long-running operation metadata message returned by the ReconcileTags.
+      class GoogleCloudDatacatalogV1ReconcileTagsMetadata
+        include Google::Apis::Core::Hashable
+      
+        # Maps the name of each tagged column (or empty string for a sole entry) to
+        # tagging operation status.
+        # Corresponds to the JSON property `errors`
+        # @return [Hash<String,Google::Apis::DatacatalogV1::Status>]
+        attr_accessor :errors
+      
+        # State of the reconciliation operation.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @errors = args[:errors] if args.key?(:errors)
+          @state = args[:state] if args.key?(:state)
+        end
+      end
+      
+      # Request message for ReconcileTags.
+      class GoogleCloudDatacatalogV1ReconcileTagsRequest
+        include Google::Apis::Core::Hashable
+      
+        # If set to `true`, deletes entry tags related to a tag template not listed in
+        # the tags source from an entry. If set to `false`, unlisted tags are retained.
+        # Corresponds to the JSON property `forceDeleteMissing`
+        # @return [Boolean]
+        attr_accessor :force_delete_missing
+        alias_method :force_delete_missing?, :force_delete_missing
+      
+        # Required. The name of the tag template, which is used for reconciliation.
+        # Corresponds to the JSON property `tagTemplate`
+        # @return [String]
+        attr_accessor :tag_template
+      
+        # A list of tags to apply to an entry. A tag can specify a tag template, which
+        # must be the template specified in the `ReconcileTagsRequest`. The sole entry
+        # and each of its columns must be mentioned at most once.
+        # Corresponds to the JSON property `tags`
+        # @return [Array<Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Tag>]
+        attr_accessor :tags
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @force_delete_missing = args[:force_delete_missing] if args.key?(:force_delete_missing)
+          @tag_template = args[:tag_template] if args.key?(:tag_template)
+          @tags = args[:tags] if args.key?(:tags)
+        end
+      end
+      
+      # Long-running operation response message returned by ReconcileTags.
+      class GoogleCloudDatacatalogV1ReconcileTagsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Number of tags created in the request.
+        # Corresponds to the JSON property `createdTagsCount`
+        # @return [Fixnum]
+        attr_accessor :created_tags_count
+      
+        # Number of tags deleted in the request.
+        # Corresponds to the JSON property `deletedTagsCount`
+        # @return [Fixnum]
+        attr_accessor :deleted_tags_count
+      
+        # Number of tags updated in the request.
+        # Corresponds to the JSON property `updatedTagsCount`
+        # @return [Fixnum]
+        attr_accessor :updated_tags_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @created_tags_count = args[:created_tags_count] if args.key?(:created_tags_count)
+          @deleted_tags_count = args[:deleted_tags_count] if args.key?(:deleted_tags_count)
+          @updated_tags_count = args[:updated_tags_count] if args.key?(:updated_tags_count)
+        end
+      end
+      
       # Request message for RenameTagTemplateFieldEnumValue.
       class GoogleCloudDatacatalogV1RenameTagTemplateFieldEnumValueRequest
         include Google::Apis::Core::Hashable
@@ -2109,9 +2201,9 @@ module Google
       class GoogleCloudDatacatalogV1SearchCatalogRequestScope
         include Google::Apis::Core::Hashable
       
-        # If `true`, include Google Cloud Platform (GCP) public datasets in search
-        # results. By default, they are excluded. See [Google Cloud Public Datasets](/
-        # public-datasets) for more information.
+        # If `true`, include Google Cloud public datasets in search results. By default,
+        # they are excluded. See [Google Cloud Public Datasets](/public-datasets) for
+        # more information.
         # Corresponds to the JSON property `includeGcpPublicDatasets`
         # @return [Boolean]
         attr_accessor :include_gcp_public_datasets
@@ -2673,10 +2765,10 @@ module Google
       end
       
       # A tag template defines a tag that can have one or more typed fields. The
-      # template is used to create tags that are attached to GCP resources. [Tag
-      # template roles] (https://cloud.google.com/iam/docs/understanding-roles#data-
-      # catalog-roles) provide permissions to create, edit, and use the template. For
-      # example, see the [TagTemplate User] (https://cloud.google.com/data-catalog/
+      # template is used to create tags that are attached to Google Cloud resources. [
+      # Tag template roles] (https://cloud.google.com/iam/docs/understanding-roles#
+      # data-catalog-roles) provide permissions to create, edit, and use the template.
+      # For example, see the [TagTemplate User] (https://cloud.google.com/data-catalog/
       # docs/how-to/template-user) role that includes a permission to use the tag
       # template to tag resources.
       class GoogleCloudDatacatalogV1TagTemplate
@@ -2866,7 +2958,7 @@ module Google
         # @return [String]
         attr_accessor :identity
       
-        # The GCP service name.
+        # The Google Cloud service name.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

data/lib/google/apis/datacatalog_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module DatacatalogV1
       # Version of the google-apis-datacatalog_v1 gem
-      GEM_VERSION = "0.29.0"
+      GEM_VERSION = "0.31.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.11.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230117"
+      REVISION = "20230207"
     end
   end
 end

data/lib/google/apis/datacatalog_v1/representations.rb

@@ -370,6 +370,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleCloudDatacatalogV1ReconcileTagsMetadata
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDatacatalogV1ReconcileTagsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleCloudDatacatalogV1ReconcileTagsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudDatacatalogV1RenameTagTemplateFieldEnumValueRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1146,6 +1164,34 @@ module Google
         end
       end
       
+      class GoogleCloudDatacatalogV1ReconcileTagsMetadata
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          hash :errors, as: 'errors', class: Google::Apis::DatacatalogV1::Status, decorator: Google::Apis::DatacatalogV1::Status::Representation
+      
+          property :state, as: 'state'
+        end
+      end
+      
+      class GoogleCloudDatacatalogV1ReconcileTagsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :force_delete_missing, as: 'forceDeleteMissing'
+          property :tag_template, as: 'tagTemplate'
+          collection :tags, as: 'tags', class: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Tag, decorator: Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1Tag::Representation
+      
+        end
+      end
+      
+      class GoogleCloudDatacatalogV1ReconcileTagsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :created_tags_count, :numeric_string => true, as: 'createdTagsCount'
+          property :deleted_tags_count, :numeric_string => true, as: 'deletedTagsCount'
+          property :updated_tags_count, :numeric_string => true, as: 'updatedTagsCount'
+        end
+      end
+      
       class GoogleCloudDatacatalogV1RenameTagTemplateFieldEnumValueRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/lib/google/apis/datacatalog_v1/service.rb

@@ -625,13 +625,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Imports entries from some source (e.g. dump in a Cloud Storage bucket) to the
-        # Data Catalog. Dump here is a snapshot of the third-party system state, that
-        # needs to be ingested in the Data Catalog. Import of entries is a sync
-        # operation that reconciles state of the third-party system and Data Catalog.
-        # ImportEntries is a long-running operation done in the background, so this
-        # method returns long-running operation resource. The resource can be queried
-        # with Operations.GetOperation which contains metadata and response.
+        # Imports entries from a source, such as data previously dumped into a Cloud
+        # Storage bucket, into Data Catalog. `ImportEntries` accepts source data
+        # snapshots of third-party system state. Import of entries is a sync operation
+        # that reconciles the state of the third-party system with Data Catalog. `
+        # ImportEntries` returns a long-running operation resource that can be queried
+        # with Operations.GetOperation to return ImportEntriesMetadata and an
+        # ImportEntriesResponse message.
         # @param [String] parent
         #   Required. Target entry group for ingested entries.
         # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ImportEntriesRequest] google_cloud_datacatalog_v1_import_entries_request_object
@@ -1089,6 +1089,44 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # `ReconcileTags` creates or updates a list of tags on the entry. If the
+        # ReconcileTagsRequest.force_delete_missing parameter is set, the operation
+        # deletes tags not included in the input tag list. `ReconcileTags` returns a
+        # long-running operation resource that can be queried with Operations.
+        # GetOperation to return ReconcileTagsMetadata and a ReconcileTagsResponse
+        # message.
+        # @param [String] parent
+        #   Required. Name of Entry to be tagged.
+        # @param [Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ReconcileTagsRequest] google_cloud_datacatalog_v1_reconcile_tags_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DatacatalogV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DatacatalogV1::Operation]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def reconcile_project_location_entry_group_entry_tag(parent, google_cloud_datacatalog_v1_reconcile_tags_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+parent}/tags:reconcile', options)
+          command.request_representation = Google::Apis::DatacatalogV1::GoogleCloudDatacatalogV1ReconcileTagsRequest::Representation
+          command.request_object = google_cloud_datacatalog_v1_reconcile_tags_request_object
+          command.response_representation = Google::Apis::DatacatalogV1::Operation::Representation
+          command.response_class = Google::Apis::DatacatalogV1::Operation
+          command.params['parent'] = parent unless parent.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a tag and assigns it to: * An Entry if the method name is `projects.
         # locations.entryGroups.entries.tags.create`. * Or EntryGroupif the method name
         # is `projects.locations.entryGroups.tags.create`. Note: The project identified

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-datacatalog_v1
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.31.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-22 00:00:00.000000000 Z
+date: 2023-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datacatalog_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-datacatalog_v1/v0.29.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-datacatalog_v1/v0.31.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-datacatalog_v1
 post_install_message: 
 rdoc_options: []