google-cloud-data_catalog-v1 0.7.1 → 0.8.1

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

@@ -21,17 +21,24 @@ module Google
   module Cloud
     module DataCatalog
       module V1
-        # Timestamps about this resource according to a particular system.
+        # Timestamps associated with this resource in a particular system.
         # @!attribute [rw] create_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The creation time of the resource within the given system.
+        #     Creation timestamp of the resource within the given system.
         # @!attribute [rw] update_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The last-modified time of the resource within the given system.
+        #     Timestamp of the last modification of the resource or its metadata within
+        #     a given system.
+        #
+        #     Note: Depending on the source system, not every modification updates this
+        #     timestamp.
+        #     For example, BigQuery timestamps every metadata modification but not data
+        #     or permission changes.
         # @!attribute [r] expire_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     Output only. The expiration time of the resource within the given system.
-        #     Currently only apllicable to BigQuery resources.
+        #     Output only. Expiration timestamp of the resource within the given system.
+        #
+        #     Currently only applicable to BigQuery resources.
         class SystemTimestamps
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module DataCatalog
+      module V1
+        # Detailed statistics on the entry's usage.
+        #
+        # Usage statistics have the following limitations:
+        #
+        # - Only BigQuery tables have them.
+        # - They only include BigQuery query jobs.
+        # - They might be underestimated because wildcard table references
+        #   are not yet counted. For more information, see
+        #   [Querying multiple tables using a wildcard table]
+        #   (https://cloud.google.com/bigquery/docs/querying-wildcard-tables)
+        # @!attribute [rw] total_completions
+        #   @return [::Float]
+        #     The number of successful uses of the underlying entry.
+        # @!attribute [rw] total_failures
+        #   @return [::Float]
+        #     The number of failed attempts to use the underlying entry.
+        # @!attribute [rw] total_cancellations
+        #   @return [::Float]
+        #     The number of cancelled attempts to use the underlying entry.
+        # @!attribute [rw] total_execution_time_for_completions_millis
+        #   @return [::Float]
+        #     Total time spent only on successful uses, in milliseconds.
+        class UsageStats
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The set of all usage signals that Data Catalog stores.
+        #
+        # Note: Usually, these signals are updated daily. In rare cases, an update may
+        # fail but will be performed again on the next day.
+        # @!attribute [rw] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The end timestamp of the duration of usage statistics.
+        # @!attribute [rw] usage_within_time_range
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DataCatalog::V1::UsageStats}]
+        #     Usage statistics over each of the predefined time ranges.
+        #
+        #     Supported time ranges are `{"24H", "7D", "30D"}`.
+        class UsageSignal
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::DataCatalog::V1::UsageStats]
+          class UsageWithinTimeRangeEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/type/expr.rb

@@ -19,30 +19,53 @@
 
 module Google
   module Type
-    # Represents an expression text. Example:
+    # Represents a textual expression in the Common Expression Language (CEL)
+    # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
+    # are documented at https://github.com/google/cel-spec.
     #
-    #     title: "User account presence"
-    #     description: "Determines whether the request has a user account"
-    #     expression: "size(request.user) > 0"
+    # Example (Comparison):
+    #
+    #     title: "Summary size limit"
+    #     description: "Determines if a summary is less than 100 chars"
+    #     expression: "document.summary.size() < 100"
+    #
+    # Example (Equality):
+    #
+    #     title: "Requestor is owner"
+    #     description: "Determines if requestor is the document owner"
+    #     expression: "document.owner == request.auth.claims.email"
+    #
+    # Example (Logic):
+    #
+    #     title: "Public documents"
+    #     description: "Determine whether the document should be publicly visible"
+    #     expression: "document.type != 'private' && document.type != 'internal'"
+    #
+    # Example (Data Manipulation):
+    #
+    #     title: "Notification string"
+    #     description: "Create a notification string with a timestamp."
+    #     expression: "'New message received at ' + string(document.create_time)"
+    #
+    # The exact variables and functions that may be referenced within an expression
+    # are determined by the service that evaluates it. See the service
+    # documentation for additional information.
     # @!attribute [rw] expression
     #   @return [::String]
-    #     Textual representation of an expression in
-    #     Common Expression Language syntax.
-    #
-    #     The application context of the containing message determines which
-    #     well-known feature set of CEL is supported.
+    #     Textual representation of an expression in Common Expression Language
+    #     syntax.
     # @!attribute [rw] title
     #   @return [::String]
-    #     An optional title for the expression, i.e. a short string describing
+    #     Optional. Title for the expression, i.e. a short string describing
     #     its purpose. This can be used e.g. in UIs which allow to enter the
     #     expression.
     # @!attribute [rw] description
     #   @return [::String]
-    #     An optional description of the expression. This is a longer text which
+    #     Optional. Description of the expression. This is a longer text which
     #     describes the expression, e.g. when hovered over it in a UI.
     # @!attribute [rw] location
     #   @return [::String]
-    #     An optional string indicating the location of the expression for error
+    #     Optional. String indicating the location of the expression for error
     #     reporting, e.g. a file name and a position in the file.
     class Expr
       include ::Google::Protobuf::MessageExts

metadata

@@ -1,29 +1,35 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-data_catalog-v1
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-27 00:00:00.000000000 Z
+date: 2021-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.7'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.4'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -47,7 +53,7 @@ dependencies:
         version: 0.6.10
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -57,7 +63,7 @@ dependencies:
         version: 0.6.10
     - - "<"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 2.a
 - !ruby/object:Gem::Dependency
   name: google-style
   requirement: !ruby/object:Gem::Requirement
@@ -200,6 +206,7 @@ files:
 - lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/credentials.rb
 - lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/paths.rb
 - lib/google/cloud/data_catalog/v1/version.rb
+- lib/google/cloud/datacatalog/v1/bigquery_pb.rb
 - lib/google/cloud/datacatalog/v1/common_pb.rb
 - lib/google/cloud/datacatalog/v1/data_source_pb.rb
 - lib/google/cloud/datacatalog/v1/datacatalog_pb.rb
@@ -214,9 +221,11 @@ files:
 - lib/google/cloud/datacatalog/v1/table_spec_pb.rb
 - lib/google/cloud/datacatalog/v1/tags_pb.rb
 - lib/google/cloud/datacatalog/v1/timestamps_pb.rb
+- lib/google/cloud/datacatalog/v1/usage_pb.rb
 - proto_docs/README.md
 - proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/resource.rb
+- proto_docs/google/cloud/datacatalog/v1/bigquery.rb
 - proto_docs/google/cloud/datacatalog/v1/common.rb
 - proto_docs/google/cloud/datacatalog/v1/data_source.rb
 - proto_docs/google/cloud/datacatalog/v1/datacatalog.rb
@@ -228,6 +237,7 @@ files:
 - proto_docs/google/cloud/datacatalog/v1/table_spec.rb
 - proto_docs/google/cloud/datacatalog/v1/tags.rb
 - proto_docs/google/cloud/datacatalog/v1/timestamps.rb
+- proto_docs/google/cloud/datacatalog/v1/usage.rb
 - proto_docs/google/iam/v1/iam_policy.rb
 - proto_docs/google/iam/v1/options.rb
 - proto_docs/google/iam/v1/policy.rb
@@ -254,7 +264,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.13
+rubygems_version: 3.2.17
 signing_key: 
 specification_version: 4
 summary: API Client library for the Data Catalog V1 API