google-shopping-merchant-accounts-v1 0.3.0 → 0.3.2

data/lib/google/shopping/merchant/accounts/v1/developer_registration_service/client.rb

@@ -221,7 +221,9 @@ module Google
               #     updated to have the new "API notifications" preference. If the developer
               #     email provided is not associated with any user we will just add it as a
               #     contact. The email preference corresponding to that contact will have the
-              #     new "API notifications" preference
+              #     new "API notifications" preference. Make sure the email used is associated
+              #     with a Google Account (Google Workspace account or Gmail account)
+              #     and is not a service account as service accounts can't receive emails.
               #
               # @yield [response, operation] Access the result along with the RPC operation
               # @yieldparam response [::Google::Shopping::Merchant::Accounts::V1::DeveloperRegistration]
@@ -461,6 +463,75 @@ module Google
                 raise ::Google::Cloud::Error.from_error(e)
               end
 
+              ##
+              # Retrieves the merchant account that the calling GCP is registered with.
+              #
+              # @overload get_account_for_gcp_registration(request, options = nil)
+              #   Pass arguments to `get_account_for_gcp_registration` via a request object, either of type
+              #   {::Google::Protobuf::Empty} or an equivalent Hash.
+              #
+              #   @param request [::Google::Protobuf::Empty, ::Hash]
+              #     A request object representing the call parameters. Required. To specify no
+              #     parameters, or to keep all the default parameter values, pass an empty Hash.
+              #   @param options [::Gapic::CallOptions, ::Hash]
+              #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+              #
+              # @yield [response, operation] Access the result along with the RPC operation
+              # @yieldparam response [::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse]
+              # @yieldparam operation [::GRPC::ActiveCall::Operation]
+              #
+              # @return [::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse]
+              #
+              # @raise [::Google::Cloud::Error] if the RPC is aborted.
+              #
+              # @example Basic example
+              #   require "google/shopping/merchant/accounts/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Shopping::Merchant::Accounts::V1::DeveloperRegistrationService::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Protobuf::Empty.new
+              #
+              #   # Call the get_account_for_gcp_registration method.
+              #   result = client.get_account_for_gcp_registration request
+              #
+              #   # The returned object is of type Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse.
+              #   p result
+              #
+              def get_account_for_gcp_registration request, options = nil
+                raise ::ArgumentError, "request must be provided" if request.nil?
+
+                request = ::Gapic::Protobuf.coerce request, to: ::Google::Protobuf::Empty
+
+                # Converts hash and nil to an options object
+                options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                # Customize the options with defaults
+                metadata = @config.rpcs.get_account_for_gcp_registration.metadata.to_h
+
+                # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                  lib_name: @config.lib_name, lib_version: @config.lib_version,
+                  gapic_version: ::Google::Shopping::Merchant::Accounts::V1::VERSION
+                metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                options.apply_defaults timeout:      @config.rpcs.get_account_for_gcp_registration.timeout,
+                                       metadata:     metadata,
+                                       retry_policy: @config.rpcs.get_account_for_gcp_registration.retry_policy
+
+                options.apply_defaults timeout:      @config.timeout,
+                                       metadata:     @config.metadata,
+                                       retry_policy: @config.retry_policy
+
+                @developer_registration_service_stub.call_rpc :get_account_for_gcp_registration, request, options: options do |response, operation|
+                  yield response, operation if block_given?
+                end
+              rescue ::GRPC::BadStatus => e
+                raise ::Google::Cloud::Error.from_error(e)
+              end
+
               ##
               # Configuration class for the DeveloperRegistrationService API.
               #
@@ -496,8 +567,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
@@ -506,7 +575,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::Shopping::Merchant::Accounts::V1::DeveloperRegistrationService::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.
@@ -642,6 +730,11 @@ module Google
                   # @return [::Gapic::Config::Method]
                   #
                   attr_reader :unregister_gcp
+                  ##
+                  # RPC-specific configuration for `get_account_for_gcp_registration`
+                  # @return [::Gapic::Config::Method]
+                  #
+                  attr_reader :get_account_for_gcp_registration
 
                   # @private
                   def initialize parent_rpcs = nil
@@ -651,6 +744,8 @@ module Google
                     @get_developer_registration = ::Gapic::Config::Method.new get_developer_registration_config
                     unregister_gcp_config = parent_rpcs.unregister_gcp if parent_rpcs.respond_to? :unregister_gcp
                     @unregister_gcp = ::Gapic::Config::Method.new unregister_gcp_config
+                    get_account_for_gcp_registration_config = parent_rpcs.get_account_for_gcp_registration if parent_rpcs.respond_to? :get_account_for_gcp_registration
+                    @get_account_for_gcp_registration = ::Gapic::Config::Method.new get_account_for_gcp_registration_config
 
                     yield self if block_given?
                   end

data/lib/google/shopping/merchant/accounts/v1/developer_registration_service/rest/client.rb

@@ -214,7 +214,9 @@ module Google
                 #     updated to have the new "API notifications" preference. If the developer
                 #     email provided is not associated with any user we will just add it as a
                 #     contact. The email preference corresponding to that contact will have the
-                #     new "API notifications" preference
+                #     new "API notifications" preference. Make sure the email used is associated
+                #     with a Google Account (Google Workspace account or Gmail account)
+                #     and is not a service account as service accounts can't receive emails.
                 # @yield [result, operation] Access the result along with the TransportOperation object
                 # @yieldparam result [::Google::Shopping::Merchant::Accounts::V1::DeveloperRegistration]
                 # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -433,6 +435,76 @@ module Google
                   raise ::Google::Cloud::Error.from_error(e)
                 end
 
+                ##
+                # Retrieves the merchant account that the calling GCP is registered with.
+                #
+                # @overload get_account_for_gcp_registration(request, options = nil)
+                #   Pass arguments to `get_account_for_gcp_registration` via a request object, either of type
+                #   {::Google::Protobuf::Empty} or an equivalent Hash.
+                #
+                #   @param request [::Google::Protobuf::Empty, ::Hash]
+                #     A request object representing the call parameters. Required. To specify no
+                #     parameters, or to keep all the default parameter values, pass an empty Hash.
+                #   @param options [::Gapic::CallOptions, ::Hash]
+                #     Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse]
+                #
+                # @raise [::Google::Cloud::Error] if the REST call is aborted.
+                #
+                # @example Basic example
+                #   require "google/shopping/merchant/accounts/v1"
+                #
+                #   # Create a client object. The client can be reused for multiple calls.
+                #   client = Google::Shopping::Merchant::Accounts::V1::DeveloperRegistrationService::Rest::Client.new
+                #
+                #   # Create a request. To set request fields, pass in keyword arguments.
+                #   request = Google::Protobuf::Empty.new
+                #
+                #   # Call the get_account_for_gcp_registration method.
+                #   result = client.get_account_for_gcp_registration request
+                #
+                #   # The returned object is of type Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse.
+                #   p result
+                #
+                def get_account_for_gcp_registration request, options = nil
+                  raise ::ArgumentError, "request must be provided" if request.nil?
+
+                  request = ::Gapic::Protobuf.coerce request, to: ::Google::Protobuf::Empty
+
+                  # Converts hash and nil to an options object
+                  options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+                  # Customize the options with defaults
+                  call_metadata = @config.rpcs.get_account_for_gcp_registration.metadata.to_h
+
+                  # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
+                  call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                    lib_name: @config.lib_name, lib_version: @config.lib_version,
+                    gapic_version: ::Google::Shopping::Merchant::Accounts::V1::VERSION,
+                    transports_version_send: [:rest]
+
+                  call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
+                  call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+                  options.apply_defaults timeout:      @config.rpcs.get_account_for_gcp_registration.timeout,
+                                         metadata:     call_metadata,
+                                         retry_policy: @config.rpcs.get_account_for_gcp_registration.retry_policy
+
+                  options.apply_defaults timeout:      @config.timeout,
+                                         metadata:     @config.metadata,
+                                         retry_policy: @config.retry_policy
+
+                  @developer_registration_service_stub.get_account_for_gcp_registration request, options do |result, operation|
+                    yield result, operation if block_given?
+                  end
+                rescue ::Gapic::Rest::Error => e
+                  raise ::Google::Cloud::Error.from_error(e)
+                end
+
                 ##
                 # Configuration class for the DeveloperRegistrationService REST API.
                 #
@@ -594,6 +666,11 @@ module Google
                     # @return [::Gapic::Config::Method]
                     #
                     attr_reader :unregister_gcp
+                    ##
+                    # RPC-specific configuration for `get_account_for_gcp_registration`
+                    # @return [::Gapic::Config::Method]
+                    #
+                    attr_reader :get_account_for_gcp_registration
 
                     # @private
                     def initialize parent_rpcs = nil
@@ -603,6 +680,8 @@ module Google
                       @get_developer_registration = ::Gapic::Config::Method.new get_developer_registration_config
                       unregister_gcp_config = parent_rpcs.unregister_gcp if parent_rpcs.respond_to? :unregister_gcp
                       @unregister_gcp = ::Gapic::Config::Method.new unregister_gcp_config
+                      get_account_for_gcp_registration_config = parent_rpcs.get_account_for_gcp_registration if parent_rpcs.respond_to? :get_account_for_gcp_registration
+                      @get_account_for_gcp_registration = ::Gapic::Config::Method.new get_account_for_gcp_registration_config
 
                       yield self if block_given?
                     end

data/lib/google/shopping/merchant/accounts/v1/developer_registration_service/rest/service_stub.rb

@@ -194,6 +194,46 @@ module Google
                   end
                 end
 
+                ##
+                # Baseline implementation for the get_account_for_gcp_registration REST call
+                #
+                # @param request_pb [::Google::Protobuf::Empty]
+                #   A request object representing the call parameters. Required.
+                # @param options [::Gapic::CallOptions]
+                #   Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
+                #
+                # @yield [result, operation] Access the result along with the TransportOperation object
+                # @yieldparam result [::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse]
+                # @yieldparam operation [::Gapic::Rest::TransportOperation]
+                #
+                # @return [::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse]
+                #   A result object deserialized from the server's reply
+                def get_account_for_gcp_registration request_pb, options = nil
+                  raise ::ArgumentError, "request must be provided" if request_pb.nil?
+
+                  verb, uri, query_string_params, body = ServiceStub.transcode_get_account_for_gcp_registration_request request_pb
+                  query_string_params = if query_string_params.any?
+                                          query_string_params.to_h { |p| p.split "=", 2 }
+                                        else
+                                          {}
+                                        end
+
+                  response = @client_stub.make_http_request(
+                    verb,
+                    uri: uri,
+                    body: body || "",
+                    params: query_string_params,
+                    method_name: "get_account_for_gcp_registration",
+                    options: options
+                  )
+                  operation = ::Gapic::Rest::TransportOperation.new response
+                  result = ::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse.decode_json response.body, ignore_unknown_fields: true
+                  catch :response do
+                    yield result, operation if block_given?
+                    result
+                  end
+                end
+
                 ##
                 # @private
                 #
@@ -258,6 +298,25 @@ module Google
                                                           )
                   transcoder.transcode request_pb
                 end
+
+                ##
+                # @private
+                #
+                # GRPC transcoding helper method for the get_account_for_gcp_registration REST call
+                #
+                # @param request_pb [::Google::Protobuf::Empty]
+                #   A request object representing the call parameters. Required.
+                # @return [Array(String, [String, nil], Hash{String => String})]
+                #   Uri, Body, Query string parameters
+                def self.transcode_get_account_for_gcp_registration_request request_pb
+                  transcoder = Gapic::Rest::GrpcTranscoder.new
+                                                          .with_bindings(
+                                                            uri_method: :get,
+                                                            uri_template: "/accounts/v1/accounts:getAccountForGcpRegistration",
+                                                            matches: []
+                                                          )
+                  transcoder.transcode request_pb
+                end
               end
             end
           end

data/lib/google/shopping/merchant/accounts/v1/developerregistration_pb.rb

@@ -11,7 +11,7 @@ require 'google/api/resource_pb'
 require 'google/protobuf/empty_pb'
 
 
-descriptor_data = "\n@google/shopping/merchant/accounts/v1/developerregistration.proto\x12$google.shopping.merchant.accounts.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1bgoogle/protobuf/empty.proto\"\xd1\x01\n\x15\x44\x65veloperRegistration\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12\x14\n\x07gcp_ids\x18\x02 \x03(\tB\x03\xe0\x41\x03:\x8e\x01\xea\x41\x8a\x01\n0merchantapi.googleapis.com/DeveloperRegistration\x12(accounts/{account}/developerRegistration*\x15\x64\x65veloperRegistration2\x15\x64\x65veloperRegistration\"z\n\x12RegisterGcpRequest\x12\x46\n\x04name\x18\x01 \x01(\tB8\xe0\x41\x02\xfa\x41\x32\n0merchantapi.googleapis.com/DeveloperRegistration\x12\x1c\n\x0f\x64\x65veloper_email\x18\x02 \x01(\tB\x03\xe0\x41\x05\"^\n\x14UnregisterGcpRequest\x12\x46\n\x04name\x18\x01 \x01(\tB8\xe0\x41\x02\xfa\x41\x32\n0merchantapi.googleapis.com/DeveloperRegistration\"i\n\x1fGetDeveloperRegistrationRequest\x12\x46\n\x04name\x18\x01 \x01(\tB8\xe0\x41\x02\xfa\x41\x32\n0merchantapi.googleapis.com/DeveloperRegistration2\xd6\x05\n\x1c\x44\x65veloperRegistrationService\x12\xd1\x01\n\x0bRegisterGcp\x12\x38.google.shopping.merchant.accounts.v1.RegisterGcpRequest\x1a;.google.shopping.merchant.accounts.v1.DeveloperRegistration\"K\x82\xd3\xe4\x93\x02\x45\"@/accounts/v1/{name=accounts/*/developerRegistration}:registerGcp:\x01*\x12\xe3\x01\n\x18GetDeveloperRegistration\x12\x45.google.shopping.merchant.accounts.v1.GetDeveloperRegistrationRequest\x1a;.google.shopping.merchant.accounts.v1.DeveloperRegistration\"C\xda\x41\x04name\x82\xd3\xe4\x93\x02\x36\x12\x34/accounts/v1/{name=accounts/*/developerRegistration}\x12\xb2\x01\n\rUnregisterGcp\x12:.google.shopping.merchant.accounts.v1.UnregisterGcpRequest\x1a\x16.google.protobuf.Empty\"M\x82\xd3\xe4\x93\x02G\"B/accounts/v1/{name=accounts/*/developerRegistration}:unregisterGcp:\x01*\x1aG\xca\x41\x1amerchantapi.googleapis.com\xd2\x41\'https://www.googleapis.com/auth/contentB\x8d\x02\n(com.google.shopping.merchant.accounts.v1B\x1a\x44\x65veloperRegistrationProtoP\x01ZJcloud.google.com/go/shopping/merchant/accounts/apiv1/accountspb;accountspb\xaa\x02$Google.Shopping.Merchant.Accounts.V1\xca\x02$Google\\Shopping\\Merchant\\Accounts\\V1\xea\x02(Google::Shopping::Merchant::Accounts::V1b\x06proto3"
+descriptor_data = "\n@google/shopping/merchant/accounts/v1/developerregistration.proto\x12$google.shopping.merchant.accounts.v1\x1a\x1cgoogle/api/annotations.proto\x1a\x17google/api/client.proto\x1a\x1fgoogle/api/field_behavior.proto\x1a\x19google/api/resource.proto\x1a\x1bgoogle/protobuf/empty.proto\"\xd1\x01\n\x15\x44\x65veloperRegistration\x12\x11\n\x04name\x18\x01 \x01(\tB\x03\xe0\x41\x08\x12\x14\n\x07gcp_ids\x18\x02 \x03(\tB\x03\xe0\x41\x03:\x8e\x01\xea\x41\x8a\x01\n0merchantapi.googleapis.com/DeveloperRegistration\x12(accounts/{account}/developerRegistration*\x15\x64\x65veloperRegistration2\x15\x64\x65veloperRegistration\"z\n\x12RegisterGcpRequest\x12\x46\n\x04name\x18\x01 \x01(\tB8\xe0\x41\x02\xfa\x41\x32\n0merchantapi.googleapis.com/DeveloperRegistration\x12\x1c\n\x0f\x64\x65veloper_email\x18\x02 \x01(\tB\x03\xe0\x41\x05\"^\n\x14UnregisterGcpRequest\x12\x46\n\x04name\x18\x01 \x01(\tB8\xe0\x41\x02\xfa\x41\x32\n0merchantapi.googleapis.com/DeveloperRegistration\"i\n\x1fGetDeveloperRegistrationRequest\x12\x46\n\x04name\x18\x01 \x01(\tB8\xe0\x41\x02\xfa\x41\x32\n0merchantapi.googleapis.com/DeveloperRegistration\"4\n$GetAccountForGcpRegistrationResponse\x12\x0c\n\x04name\x18\x01 \x01(\t2\x97\x07\n\x1c\x44\x65veloperRegistrationService\x12\xd1\x01\n\x0bRegisterGcp\x12\x38.google.shopping.merchant.accounts.v1.RegisterGcpRequest\x1a;.google.shopping.merchant.accounts.v1.DeveloperRegistration\"K\x82\xd3\xe4\x93\x02\x45\"@/accounts/v1/{name=accounts/*/developerRegistration}:registerGcp:\x01*\x12\xe3\x01\n\x18GetDeveloperRegistration\x12\x45.google.shopping.merchant.accounts.v1.GetDeveloperRegistrationRequest\x1a;.google.shopping.merchant.accounts.v1.DeveloperRegistration\"C\xda\x41\x04name\x82\xd3\xe4\x93\x02\x36\x12\x34/accounts/v1/{name=accounts/*/developerRegistration}\x12\xb2\x01\n\rUnregisterGcp\x12:.google.shopping.merchant.accounts.v1.UnregisterGcpRequest\x1a\x16.google.protobuf.Empty\"M\x82\xd3\xe4\x93\x02G\"B/accounts/v1/{name=accounts/*/developerRegistration}:unregisterGcp:\x01*\x12\xbe\x01\n\x1cGetAccountForGcpRegistration\x12\x16.google.protobuf.Empty\x1aJ.google.shopping.merchant.accounts.v1.GetAccountForGcpRegistrationResponse\":\x82\xd3\xe4\x93\x02\x34\x12\x32/accounts/v1/accounts:getAccountForGcpRegistration\x1aG\xca\x41\x1amerchantapi.googleapis.com\xd2\x41\'https://www.googleapis.com/auth/contentB\x8d\x02\n(com.google.shopping.merchant.accounts.v1B\x1a\x44\x65veloperRegistrationProtoP\x01ZJcloud.google.com/go/shopping/merchant/accounts/apiv1/accountspb;accountspb\xaa\x02$Google.Shopping.Merchant.Accounts.V1\xca\x02$Google\\Shopping\\Merchant\\Accounts\\V1\xea\x02(Google::Shopping::Merchant::Accounts::V1b\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 
@@ -46,6 +46,7 @@ module Google
           RegisterGcpRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.shopping.merchant.accounts.v1.RegisterGcpRequest").msgclass
           UnregisterGcpRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.shopping.merchant.accounts.v1.UnregisterGcpRequest").msgclass
           GetDeveloperRegistrationRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.shopping.merchant.accounts.v1.GetDeveloperRegistrationRequest").msgclass
+          GetAccountForGcpRegistrationResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.shopping.merchant.accounts.v1.GetAccountForGcpRegistrationResponse").msgclass
         end
       end
     end

data/lib/google/shopping/merchant/accounts/v1/developerregistration_services_pb.rb

@@ -45,6 +45,8 @@ module Google
               # GCP will still be able to access the API for at most 1 day from the
               # unregister succussful call.
               rpc :UnregisterGcp, ::Google::Shopping::Merchant::Accounts::V1::UnregisterGcpRequest, ::Google::Protobuf::Empty
+              # Retrieves the merchant account that the calling GCP is registered with.
+              rpc :GetAccountForGcpRegistration, ::Google::Protobuf::Empty, ::Google::Shopping::Merchant::Accounts::V1::GetAccountForGcpRegistrationResponse
             end
 
             Stub = Service.rpc_stub_class

data/lib/google/shopping/merchant/accounts/v1/email_preferences_service/client.rb

@@ -417,8 +417,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
@@ -427,7 +425,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::Shopping::Merchant::Accounts::V1::EmailPreferencesService::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/shopping/merchant/accounts/v1/gbp_accounts_service/client.rb

@@ -423,8 +423,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
@@ -433,7 +431,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::Shopping::Merchant::Accounts::V1::GbpAccountsService::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/shopping/merchant/accounts/v1/homepage_service/client.rb

@@ -598,8 +598,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
@@ -608,7 +606,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::Shopping::Merchant::Accounts::V1::HomepageService::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/shopping/merchant/accounts/v1/lfp_providers_service/client.rb

@@ -422,8 +422,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
@@ -432,7 +430,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::Shopping::Merchant::Accounts::V1::LfpProvidersService::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/shopping/merchant/accounts/v1/omnichannel_settings_service/client.rb

@@ -692,8 +692,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
@@ -702,7 +700,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::Shopping::Merchant::Accounts::V1::OmnichannelSettingsService::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/shopping/merchant/accounts/v1/online_return_policy_service/client.rb

@@ -595,8 +595,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
@@ -605,7 +603,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::Shopping::Merchant::Accounts::V1::OnlineReturnPolicyService::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/shopping/merchant/accounts/v1/programs_service/client.rb

@@ -594,8 +594,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
@@ -604,7 +602,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::Shopping::Merchant::Accounts::V1::ProgramsService::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.