google-cloud-service_usage-v1 1.4.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6d5122b6f9847b2533281b840968eb1fd1882c59fe1f5f4813e0e6ebc86f2ec6
-  data.tar.gz: 1927ca841ae625a0102dc2b5999ad9653d2705f6c53ae9fccdd267194ea6aee8
+  metadata.gz: 2f2f48ad83a2b0a41604195bb2f102add0b80409a7942d3c34b523814a8ad39b
+  data.tar.gz: ca97b2dd15411fb5188d5fc34debdfa9a700fc4aabca42577c8c238ad49a0d03
 SHA512:
-  metadata.gz: 536e51ae169374f75012707e17234ab39b7af8707c3f1fdef4315b2578a7931067c006f977413461b29ba250b25e7c94fdc1d584179e29ed1d364cea6e1fca0f
-  data.tar.gz: 868eb13a40f65e70d0d43d64a3fdbcc1dd7729d0b78aecf5640f7f9fa65495109ed97b16bff477ed1668172802d9e6818b428efcc137432a4249c64217c3c15f
+  metadata.gz: a9d25be9879aade89b7431db60edfb9e92b58629945d7d9af44f2d378af2cbfc8719d4cd57f7b49c01d16a854485b1084be44f3335315149716499377ac9700a
+  data.tar.gz: 44cb26b6352fd8bc62cfbfe5013e81d78457ce0861ab0f1580d4af297dee3022b234e47ee7bb8eba1d18d8b84b3bbae7ffdc159d7c9636074fe0fc04f0fc9c52

data/lib/google/cloud/service_usage/v1/service_usage/client.rb

@@ -869,8 +869,6 @@ module Google
             #   @return [::String,nil]
             # @!attribute [rw] credentials
             #   Credentials to send with calls. You may provide any of the following types:
-            #    *  (`String`) The path to a service account key file in JSON format
-            #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
             #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -879,7 +877,26 @@ module Google
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
             #
-            #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+            #   @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
+            #     is deprecated. Providing an unvalidated credential configuration to
+            #     Google APIs can compromise the security of your systems and data.
+            #
+            #   @example
+            #
+            #     # The recommended way to provide credentials is to use the `make_creds` method
+            #     # on the appropriate credentials class for your environment.
+            #
+            #     require "googleauth"
+            #
+            #     credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+            #       json_key_io: ::File.open("/path/to/keyfile.json")
+            #     )
+            #
+            #     client = ::Google::Cloud::ServiceUsage::V1::ServiceUsage::Client.new do |config|
+            #       config.credentials = credentials
+            #     end
+            #
+            #   @note Warning: If you accept a credential configuration (JSON file or Hash) from an
             #   external source for authentication to Google Cloud, you must validate it before
             #   providing it to a Google API client library. Providing an unvalidated credential
             #   configuration to Google APIs can compromise the security of your systems and data.

data/lib/google/cloud/service_usage/v1/service_usage/operations.rb

@@ -134,7 +134,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+            # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
             #   Pass arguments to `list_operations` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -147,6 +147,17 @@ module Google
             #     The standard list page size.
             #   @param page_token [::String]
             #     The standard list page token.
+            #   @param return_partial_success [::Boolean]
+            #     When set to `true`, operations that are reachable are returned as normal,
+            #     and those that are unreachable are returned in the
+            #     [ListOperationsResponse.unreachable] field.
+            #
+            #     This can only be `true` when reading across collections e.g. when `parent`
+            #     is set to `"projects/example/locations/-"`.
+            #
+            #     This field is not by default supported and will result in an
+            #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+            #     service or product specific documentation.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Gapic::Operation>]
@@ -623,8 +634,6 @@ module Google
             #   @return [::String,nil]
             # @!attribute [rw] credentials
             #   Credentials to send with calls. You may provide any of the following types:
-            #    *  (`String`) The path to a service account key file in JSON format
-            #    *  (`Hash`) A service account key as a Hash
             #    *  (`Google::Auth::Credentials`) A googleauth credentials object
             #       (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
             #    *  (`Signet::OAuth2::Client`) A signet oauth2 client object
@@ -633,7 +642,26 @@ module Google
             #    *  (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
             #    *  (`nil`) indicating no credentials
             #
-            #   Warning: If you accept a credential configuration (JSON file or Hash) from an
+            #   @note Warning: Passing a `String` to a keyfile path or a `Hash` of credentials
+            #     is deprecated. Providing an unvalidated credential configuration to
+            #     Google APIs can compromise the security of your systems and data.
+            #
+            #   @example
+            #
+            #     # The recommended way to provide credentials is to use the `make_creds` method
+            #     # on the appropriate credentials class for your environment.
+            #
+            #     require "googleauth"
+            #
+            #     credentials = ::Google::Auth::ServiceAccountCredentials.make_creds(
+            #       json_key_io: ::File.open("/path/to/keyfile.json")
+            #     )
+            #
+            #     client = ::Google::Longrunning::Operations::Client.new do |config|
+            #       config.credentials = credentials
+            #     end
+            #
+            #   @note Warning: If you accept a credential configuration (JSON file or Hash) from an
             #   external source for authentication to Google Cloud, you must validate it before
             #   providing it to a Google API client library. Providing an unvalidated credential
             #   configuration to Google APIs can compromise the security of your systems and data.

data/lib/google/cloud/service_usage/v1/service_usage/rest/operations.rb

@@ -125,7 +125,7 @@ module Google
               #   @param options [::Gapic::CallOptions, ::Hash]
               #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
               #
-              # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil)
+              # @overload list_operations(name: nil, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil)
               #   Pass arguments to `list_operations` via keyword arguments. Note that at
               #   least one keyword argument is required. To specify no parameters, or to keep all
               #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -138,6 +138,17 @@ module Google
               #     The standard list page size.
               #   @param page_token [::String]
               #     The standard list page token.
+              #   @param return_partial_success [::Boolean]
+              #     When set to `true`, operations that are reachable are returned as normal,
+              #     and those that are unreachable are returned in the
+              #     [ListOperationsResponse.unreachable] field.
+              #
+              #     This can only be `true` when reading across collections e.g. when `parent`
+              #     is set to `"projects/example/locations/-"`.
+              #
+              #     This field is not by default supported and will result in an
+              #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+              #     service or product specific documentation.
               # @yield [result, operation] Access the result along with the TransportOperation object
               # @yieldparam result [::Gapic::Operation]
               # @yieldparam operation [::Gapic::Rest::TransportOperation]

data/lib/google/cloud/service_usage/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module ServiceUsage
       module V1
-        VERSION = "1.4.0"
+        VERSION = "1.5.1"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+# Copyright 2025 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 Api
+    # An indicator of the behavior of a given field (for example, that a field
+    # is required in requests, or given as output but ignored as input).
+    # This **does not** change the behavior in protocol buffers itself; it only
+    # denotes the behavior and may affect how API tooling handles the field.
+    #
+    # Note: This enum **may** receive new values in the future.
+    module FieldBehavior
+      # Conventional default for enums. Do not use this.
+      FIELD_BEHAVIOR_UNSPECIFIED = 0
+
+      # Specifically denotes a field as optional.
+      # While all fields in protocol buffers are optional, this may be specified
+      # for emphasis if appropriate.
+      OPTIONAL = 1
+
+      # Denotes a field as required.
+      # This indicates that the field **must** be provided as part of the request,
+      # and failure to do so will cause an error (usually `INVALID_ARGUMENT`).
+      REQUIRED = 2
+
+      # Denotes a field as output only.
+      # This indicates that the field is provided in responses, but including the
+      # field in a request does nothing (the server *must* ignore it and
+      # *must not* throw an error as a result of the field's presence).
+      OUTPUT_ONLY = 3
+
+      # Denotes a field as input only.
+      # This indicates that the field is provided in requests, and the
+      # corresponding field is not included in output.
+      INPUT_ONLY = 4
+
+      # Denotes a field as immutable.
+      # This indicates that the field may be set once in a request to create a
+      # resource, but may not be changed thereafter.
+      IMMUTABLE = 5
+
+      # Denotes that a (repeated) field is an unordered list.
+      # This indicates that the service may provide the elements of the list
+      # in any arbitrary  order, rather than the order the user originally
+      # provided. Additionally, the list's order may or may not be stable.
+      UNORDERED_LIST = 6
+
+      # Denotes that this field returns a non-empty default value if not set.
+      # This indicates that if the user provides the empty value in a request,
+      # a non-empty value will be returned. The user will not be aware of what
+      # non-empty value to expect.
+      NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
+    end
+  end
+end

data/proto_docs/google/longrunning/operations.rb

@@ -83,6 +83,18 @@ module Google
     # @!attribute [rw] page_token
     #   @return [::String]
     #     The standard list page token.
+    # @!attribute [rw] return_partial_success
+    #   @return [::Boolean]
+    #     When set to `true`, operations that are reachable are returned as normal,
+    #     and those that are unreachable are returned in the
+    #     [ListOperationsResponse.unreachable] field.
+    #
+    #     This can only be `true` when reading across collections e.g. when `parent`
+    #     is set to `"projects/example/locations/-"`.
+    #
+    #     This field is not by default supported and will result in an
+    #     `UNIMPLEMENTED` error if set unless explicitly documented otherwise in
+    #     service or product specific documentation.
     class ListOperationsRequest
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -96,6 +108,12 @@ module Google
     # @!attribute [rw] next_page_token
     #   @return [::String]
     #     The standard List next-page token.
+    # @!attribute [rw] unreachable
+    #   @return [::Array<::String>]
+    #     Unordered list. Unreachable resources. Populated when the request sets
+    #     `ListOperationsRequest.return_partial_success` and reads across
+    #     collections e.g. when attempting to list all resources across all supported
+    #     locations.
     class ListOperationsResponse
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-service_usage-v1
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.1
 platform: ruby
 authors:
 - Google LLC
@@ -72,6 +72,7 @@ files:
 - proto_docs/google/api/client.rb
 - proto_docs/google/api/documentation.rb
 - proto_docs/google/api/endpoint.rb
+- proto_docs/google/api/field_behavior.rb
 - proto_docs/google/api/label.rb
 - proto_docs/google/api/launch_stage.rb
 - proto_docs/google/api/monitored_resource.rb