google-cloud-data_catalog-v1 0.15.0 → 0.16.0

data/lib/google/cloud/datacatalog/v1/timestamps_pb.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/datacatalog/v1/timestamps.proto
 
@@ -6,14 +7,32 @@ require 'google/protobuf'
 require 'google/api/field_behavior_pb'
 require 'google/protobuf/timestamp_pb'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/cloud/datacatalog/v1/timestamps.proto", :syntax => :proto3) do
-    add_message "google.cloud.datacatalog.v1.SystemTimestamps" do
-      optional :create_time, :message, 1, "google.protobuf.Timestamp"
-      optional :update_time, :message, 2, "google.protobuf.Timestamp"
-      optional :expire_time, :message, 3, "google.protobuf.Timestamp"
+
+descriptor_data = "\n,google/cloud/datacatalog/v1/timestamps.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\xaa\x01\n\x10SystemTimestamps\x12/\n\x0b\x63reate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12/\n\x0bupdate_time\x18\x02 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x34\n\x0b\x65xpire_time\x18\x03 \x01(\x0b\x32\x1a.google.protobuf.TimestampB\x03\xe0\x41\x03\x42\xc6\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZAcloud.google.com/go/datacatalog/apiv1/datacatalogpb;datacatalogpb\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google

data/lib/google/cloud/datacatalog/v1/usage_pb.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 # Generated by the protocol buffer compiler.  DO NOT EDIT!
 # source: google/cloud/datacatalog/v1/usage.proto
 
@@ -6,24 +7,32 @@ require 'google/protobuf'
 require 'google/api/field_behavior_pb'
 require 'google/protobuf/timestamp_pb'
 
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("google/cloud/datacatalog/v1/usage.proto", :syntax => :proto3) do
-    add_message "google.cloud.datacatalog.v1.UsageStats" do
-      optional :total_completions, :float, 1
-      optional :total_failures, :float, 2
-      optional :total_cancellations, :float, 3
-      optional :total_execution_time_for_completions_millis, :float, 4
-    end
-    add_message "google.cloud.datacatalog.v1.CommonUsageStats" do
-      proto3_optional :view_count, :int64, 1
-    end
-    add_message "google.cloud.datacatalog.v1.UsageSignal" do
-      optional :update_time, :message, 1, "google.protobuf.Timestamp"
-      map :usage_within_time_range, :string, :message, 2, "google.cloud.datacatalog.v1.UsageStats"
-      map :common_usage_within_time_range, :string, :message, 3, "google.cloud.datacatalog.v1.CommonUsageStats"
-      proto3_optional :favorite_count, :int64, 4
+
+descriptor_data = "\n\'google/cloud/datacatalog/v1/usage.proto\x12\x1bgoogle.cloud.datacatalog.v1\x1a\x1fgoogle/api/field_behavior.proto\x1a\x1fgoogle/protobuf/timestamp.proto\"\x91\x01\n\nUsageStats\x12\x19\n\x11total_completions\x18\x01 \x01(\x02\x12\x16\n\x0etotal_failures\x18\x02 \x01(\x02\x12\x1b\n\x13total_cancellations\x18\x03 \x01(\x02\x12\x33\n+total_execution_time_for_completions_millis\x18\x04 \x01(\x02\":\n\x10\x43ommonUsageStats\x12\x17\n\nview_count\x18\x01 \x01(\x03H\x00\x88\x01\x01\x42\r\n\x0b_view_count\"\xa2\x04\n\x0bUsageSignal\x12/\n\x0bupdate_time\x18\x01 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12h\n\x17usage_within_time_range\x18\x02 \x03(\x0b\x32\x42.google.cloud.datacatalog.v1.UsageSignal.UsageWithinTimeRangeEntryB\x03\xe0\x41\x03\x12p\n\x1e\x63ommon_usage_within_time_range\x18\x03 \x03(\x0b\x32H.google.cloud.datacatalog.v1.UsageSignal.CommonUsageWithinTimeRangeEntry\x12\x1b\n\x0e\x66\x61vorite_count\x18\x04 \x01(\x03H\x00\x88\x01\x01\x1a\x64\n\x19UsageWithinTimeRangeEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\x36\n\x05value\x18\x02 \x01(\x0b\x32\'.google.cloud.datacatalog.v1.UsageStats:\x02\x38\x01\x1ap\n\x1f\x43ommonUsageWithinTimeRangeEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12<\n\x05value\x18\x02 \x01(\x0b\x32-.google.cloud.datacatalog.v1.CommonUsageStats:\x02\x38\x01\x42\x11\n\x0f_favorite_countB\xc6\x01\n\x1f\x63om.google.cloud.datacatalog.v1P\x01ZAcloud.google.com/go/datacatalog/apiv1/datacatalogpb;datacatalogpb\xf8\x01\x01\xaa\x02\x1bGoogle.Cloud.DataCatalog.V1\xca\x02\x1bGoogle\\Cloud\\DataCatalog\\V1\xea\x02\x1eGoogle::Cloud::DataCatalog::V1b\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError => e
+  # Compatibility code: will be removed in the next major version.
+  require 'google/protobuf/descriptor_pb'
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = [
+    ["google.protobuf.Timestamp", "google/protobuf/timestamp.proto"],
+  ]
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
     end
   end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
 end
 
 module Google

data/proto_docs/google/api/client.rb

@@ -83,7 +83,7 @@ module Google
     #     long-running operation pattern.
     # @!attribute [rw] new_issue_uri
     #   @return [::String]
-    #     Link to a place that API users can report issues.  Example:
+    #     Link to a *public* URI where users can report issues.  Example:
     #     https://issuetracker.google.com/issues/new?component=190865&template=1161103
     # @!attribute [rw] documentation_uri
     #   @return [::String]
@@ -209,9 +209,57 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from original service names to renamed versions.
+    #     This is used when the default generated types
+    #     would cause a naming conflict. (Neither name is
+    #     fully-qualified.)
+    #     Example: Subscriber to SubscriberServiceApi.
+    # @!attribute [rw] renamed_resources
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map from full resource types to the effective short name
+    #     for the resource. This is used when otherwise resource
+    #     named from different services would cause naming collisions.
+    #     Example entry:
+    #     "datalabeling.googleapis.com/Dataset": "DataLabelingDataset"
+    # @!attribute [rw] ignored_resources
+    #   @return [::Array<::String>]
+    #     List of full resource types to ignore during generation.
+    #     This is typically used for API-specific Location resources,
+    #     which should be handled by the generator as if they were actually
+    #     the common Location resources.
+    #     Example entry: "documentai.googleapis.com/Location"
+    # @!attribute [rw] forced_namespace_aliases
+    #   @return [::Array<::String>]
+    #     Namespaces which must be aliased in snippets due to
+    #     a known (but non-generator-predictable) naming collision
+    # @!attribute [rw] handwritten_signatures
+    #   @return [::Array<::String>]
+    #     Method signatures (in the form "service.method(signature)")
+    #     which are provided separately, so shouldn't be generated.
+    #     Snippets *calling* these methods are still generated, however.
     class DotnetSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedResourcesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Ruby client libraries.
@@ -305,6 +353,15 @@ module Google
 
       # Street View Org.
       STREET_VIEW = 4
+
+      # Shopping Org.
+      SHOPPING = 5
+
+      # Geo Org.
+      GEO = 6
+
+      # Generative AI - https://developers.generativeai.google
+      GENERATIVE_AI = 7
     end
 
     # To where should client libraries be published?

data/proto_docs/google/cloud/datacatalog/v1/common.rb

@@ -50,6 +50,12 @@ module Google
           # Dataplex.
           DATAPLEX = 4
 
+          # Cloud Spanner
+          CLOUD_SPANNER = 6
+
+          # Cloud Bigtable
+          CLOUD_BIGTABLE = 7
+
           # Cloud Sql
           CLOUD_SQL = 8
 

data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb

@@ -129,6 +129,9 @@ module Google
         # @!attribute [rw] results
         #   @return [::Array<::Google::Cloud::DataCatalog::V1::SearchCatalogResult>]
         #     Search results.
+        # @!attribute [rw] total_size
+        #   @return [::Integer]
+        #     The approximate total number of entries matched by the query.
         # @!attribute [rw] next_page_token
         #   @return [::String]
         #     Pagination token that can be used in subsequent calls to retrieve the next
@@ -362,7 +365,9 @@ module Google
         #     (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical).
         # @!attribute [rw] fully_qualified_name
         #   @return [::String]
-        #     Fully qualified name (FQN) of the resource.
+        #     [Fully Qualified Name
+        #     (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names)
+        #     of the resource.
         #
         #     FQNs take two forms:
         #
@@ -377,6 +382,16 @@ module Google
         #     Example for a DPMS table:
         #
         #     `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
+        # @!attribute [rw] project
+        #   @return [::String]
+        #     Project where the lookup should be performed. Required to lookup
+        #     entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
+        #     using its `fully_qualified_name`. Ignored in other cases.
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Location where the lookup should be performed. Required to lookup
+        #     entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
+        #     using its `fully_qualified_name`. Ignored in other cases.
         class LookupEntryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -420,25 +435,11 @@ module Google
         #     The maximum size is 200 bytes when encoded in UTF-8.
         # @!attribute [rw] fully_qualified_name
         #   @return [::String]
-        #     Fully qualified name (FQN) of the resource. Set automatically for entries
-        #     representing resources from synced systems. Settable only during creation
-        #     and read-only afterwards. Can be used for search and lookup of the entries.
-        #
-        #
-        #
-        #     FQNs take two forms:
-        #
-        #     * For non-regionalized resources:
-        #
-        #       `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
-        #
-        #     * For regionalized resources:
-        #
-        #       `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
-        #
-        #     Example for a DPMS table:
-        #
-        #     `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
+        #     [Fully Qualified Name
+        #     (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names)
+        #     of the resource. Set automatically for entries representing resources from
+        #     synced systems. Settable only during creation, and read-only later. Can
+        #     be used for search and lookup of the entries.
         # @!attribute [rw] type
         #   @return [::Google::Cloud::DataCatalog::V1::EntryType]
         #     The type of the entry.
@@ -484,6 +485,10 @@ module Google
         #   @return [::Google::Cloud::DataCatalog::V1::LookerSystemSpec]
         #     Specification that applies to Looker sysstem. Only settable when
         #     `user_specified_system` is equal to `LOOKER`
+        # @!attribute [rw] cloud_bigtable_system_spec
+        #   @return [::Google::Cloud::DataCatalog::V1::CloudBigtableSystemSpec]
+        #     Specification that applies to Cloud Bigtable system. Only settable when
+        #     `integrated_system` is equal to `CLOUD_BIGTABLE`
         # @!attribute [rw] gcs_fileset_spec
         #   @return [::Google::Cloud::DataCatalog::V1::GcsFilesetSpec]
         #     Specification that applies to a Cloud Storage fileset. Valid only
@@ -515,6 +520,9 @@ module Google
         #   @return [::Google::Cloud::DataCatalog::V1::FilesetSpec]
         #     Specification that applies to a fileset resource. Valid only
         #     for entries with the `FILESET` type.
+        # @!attribute [rw] service_spec
+        #   @return [::Google::Cloud::DataCatalog::V1::ServiceSpec]
+        #     Specification that applies to a Service resource.
         # @!attribute [rw] display_name
         #   @return [::String]
         #     Display name of an entry.
@@ -789,6 +797,58 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Specification that applies to
+        # all entries that are part of `CLOUD_BIGTABLE` system
+        # (user_specified_type)
+        # @!attribute [rw] instance_display_name
+        #   @return [::String]
+        #     Display name of the Instance. This is user specified and different from
+        #     the resource name.
+        class CloudBigtableSystemSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Specification that applies to Instance
+        # entries that are part of `CLOUD_BIGTABLE` system.
+        # (user_specified_type)
+        # @!attribute [rw] cloud_bigtable_cluster_specs
+        #   @return [::Array<::Google::Cloud::DataCatalog::V1::CloudBigtableInstanceSpec::CloudBigtableClusterSpec>]
+        #     The list of clusters for the Instance.
+        class CloudBigtableInstanceSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Spec that applies to clusters of an Instance of Cloud Bigtable.
+          # @!attribute [rw] display_name
+          #   @return [::String]
+          #     Name of the cluster.
+          # @!attribute [rw] location
+          #   @return [::String]
+          #     Location of the cluster, typically a Cloud zone.
+          # @!attribute [rw] type
+          #   @return [::String]
+          #     Type of the resource. For a cluster this would be "CLUSTER".
+          # @!attribute [rw] linked_resource
+          #   @return [::String]
+          #     A link back to the parent resource, in this case Instance.
+          class CloudBigtableClusterSpec
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Specification that applies to a Service resource. Valid only
+        # for entries with the `SERVICE` type.
+        # @!attribute [rw] cloud_bigtable_instance_spec
+        #   @return [::Google::Cloud::DataCatalog::V1::CloudBigtableInstanceSpec]
+        #     Specification that applies to Instance entries of `CLOUD_BIGTABLE`
+        #     system.
+        class ServiceSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Business Context of the entry.
         # @!attribute [rw] entry_overview
         #   @return [::Google::Cloud::DataCatalog::V1::EntryOverview]
@@ -1278,6 +1338,10 @@ module Google
         # @!attribute [rw] gcs_bucket_path
         #   @return [::String]
         #     Path to a Cloud Storage bucket that contains a dump ready for ingestion.
+        # @!attribute [rw] job_id
+        #   @return [::String]
+        #     Optional. (Optional) Dataplex task job id, if specified will be used as
+        #     part of ImportEntries LRO ID
         class ImportEntriesRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/datacatalog/v1/dump_content.rb

@@ -28,11 +28,11 @@ module Google
         #     Non-encrypted Data Catalog v1 Entry.
         # @!attribute [rw] present_tags
         #   @return [::Array<::Google::Cloud::DataCatalog::V1::Tag>]
-        #     Tags that should be ingested into the Data Catalog.
+        #     Optional. Tags that should be ingested into the Data Catalog.
         #     Caller should populate template name, column and fields.
         # @!attribute [rw] absent_tags
         #   @return [::Array<::Google::Cloud::DataCatalog::V1::Tag>]
-        #     Tags that should be deleted from the Data Catalog.
+        #     Optional. Tags that should be deleted from the Data Catalog.
         #     Caller should populate template name and column only.
         class TaggedEntry
           include ::Google::Protobuf::MessageExts

data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb

@@ -91,7 +91,7 @@ module Google
           #     The Google Cloud service name.
           # @!attribute [rw] identity
           #   @return [::String]
-          #     P4SA Identity of the service.
+          #     The service agent for the service.
           class Service
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/any.rb

@@ -43,8 +43,12 @@ module Google
     #     if (any.is(Foo.class)) {
     #       foo = any.unpack(Foo.class);
     #     }
+    #     // or ...
+    #     if (any.isSameTypeAs(Foo.getDefaultInstance())) {
+    #       foo = any.unpack(Foo.getDefaultInstance());
+    #     }
     #
-    # Example 3: Pack and unpack a message in Python.
+    #  Example 3: Pack and unpack a message in Python.
     #
     #     foo = Foo(...)
     #     any = Any()
@@ -54,7 +58,7 @@ module Google
     #       any.Unpack(foo)
     #       ...
     #
-    # Example 4: Pack and unpack a message in Go
+    #  Example 4: Pack and unpack a message in Go
     #
     #      foo := &pb.Foo{...}
     #      any, err := anypb.New(foo)
@@ -73,9 +77,8 @@ module Google
     # in the type URL, for example "foo.bar.com/x/y.z" will yield type
     # name "y.z".
     #
-    #
     # JSON
-    #
+    # ====
     # The JSON representation of an `Any` value uses the regular
     # representation of the deserialized, embedded message, with an
     # additional field `@type` which contains the type URL. Example:

data/proto_docs/google/protobuf/timestamp.rb

@@ -69,7 +69,6 @@ module Google
     #     Timestamp timestamp = Timestamp.newBuilder().setSeconds(millis / 1000)
     #         .setNanos((int) ((millis % 1000) * 1000000)).build();
     #
-    #
     # Example 5: Compute Timestamp from Java `Instant.now()`.
     #
     #     Instant now = Instant.now();
@@ -78,7 +77,6 @@ module Google
     #         Timestamp.newBuilder().setSeconds(now.getEpochSecond())
     #             .setNanos(now.getNano()).build();
     #
-    #
     # Example 6: Compute Timestamp from current time in Python.
     #
     #     timestamp = Timestamp()
@@ -108,7 +106,7 @@ module Google
     # [`strftime`](https://docs.python.org/2/library/time.html#time.strftime) with
     # the time format spec '%Y-%m-%dT%H:%M:%S.%fZ'. Likewise, in Java, one can use
     # the Joda Time's [`ISODateTimeFormat.dateTime()`](
-    # http://www.joda.org/joda-time/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime%2D%2D
+    # http://joda-time.sourceforge.net/apidocs/org/joda/time/format/ISODateTimeFormat.html#dateTime()
     # ) to obtain a formatter capable of generating timestamps in this format.
     # @!attribute [rw] seconds
     #   @return [::Integer]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-data_catalog-v1
 version: !ruby/object:Gem::Version
-  version: 0.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-23 00:00:00.000000000 Z
+date: 2023-05-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.18.0
+        version: 0.19.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a