Retail V2 API - Class Google::Cloud::Retail::V2::ServingConfigService::Client (v0.12.0)

Stay organized with collections Save and categorize content based on your preferences.

Reference documentation and code samples for the Retail V2 API class Google::Cloud::Retail::V2::ServingConfigService::Client.

Client for the ServingConfigService service.

Service for modifying ServingConfig.

Inherits

  • Object

Methods

.configure

def self.configure() { |config| ... } -> Client::Configuration

Configure the ServingConfigService Client class.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter
Example
# Modify the configuration for all ServingConfigService clients
::Google::Cloud::Retail::V2::ServingConfigService::Client.configure do |config|
  config.timeout = 10.0
end

#add_control

def add_control(request, options = nil) -> ::Google::Cloud::Retail::V2::ServingConfig
def add_control(serving_config: nil, control_id: nil) -> ::Google::Cloud::Retail::V2::ServingConfig

Enables a Control on the specified ServingConfig. The control is added in the last position of the list of controls it belongs to (e.g. if it's a facet spec control it will be applied in the last position of servingConfig.facetSpecIds) Returns a ALREADY_EXISTS error if the control has already been applied. Returns a FAILED_PRECONDITION error if the addition could exceed maximum number of control allowed for that type of control.

Overloads
def add_control(request, options = nil) -> ::Google::Cloud::Retail::V2::ServingConfig
Pass arguments to add_control via a request object, either of type AddControlRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Retail::V2::AddControlRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def add_control(serving_config: nil, control_id: nil) -> ::Google::Cloud::Retail::V2::ServingConfig
Pass arguments to add_control 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).
Parameters
  • serving_config (::String) — Required. The source ServingConfig resource name . Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
  • control_id (::String) — Required. The id of the control to apply. Assumed to be in the same catalog as the serving config - if id is not found a NOT_FOUND error is returned.
Yields
  • (response, operation) — Access the result along with the RPC operation
Yield Parameters
Raises
  • (::Google::Cloud::Error) — if the RPC is aborted.
Example

Basic example

require "google/cloud/retail/v2"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::Retail::V2::ServingConfigService::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::Retail::V2::AddControlRequest.new

# Call the add_control method.
result = client.add_control request

# The returned object is of type Google::Cloud::Retail::V2::ServingConfig.
p result

#configure

def configure() { |config| ... } -> Client::Configuration

Configure the ServingConfigService Client instance.

The configuration is set to the derived mode, meaning that values can be changed, but structural changes (adding new fields, etc.) are not allowed. Structural changes should be made on Client.configure.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter

#create_serving_config

def create_serving_config(request, options = nil) -> ::Google::Cloud::Retail::V2::ServingConfig
def create_serving_config(parent: nil, serving_config: nil, serving_config_id: nil) -> ::Google::Cloud::Retail::V2::ServingConfig

Creates a ServingConfig.

A maximum of 100 {::Google::Cloud::Retail::V2::ServingConfig ServingConfig}s are allowed in a Catalog, otherwise a FAILED_PRECONDITION error is returned.

Overloads
def create_serving_config(request, options = nil) -> ::Google::Cloud::Retail::V2::ServingConfig
Pass arguments to create_serving_config via a request object, either of type CreateServingConfigRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Retail::V2::CreateServingConfigRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def create_serving_config(parent: nil, serving_config: nil, serving_config_id: nil) -> ::Google::Cloud::Retail::V2::ServingConfig
Pass arguments to create_serving_config 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).
Parameters
  • parent (::String) — Required. Full resource name of parent. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}
  • serving_config (::Google::Cloud::Retail::V2::ServingConfig, ::Hash) — Required. The ServingConfig to create.
  • serving_config_id (::String) — Required. The ID to use for the ServingConfig, which will become the final component of the ServingConfig's resource name.

    This value should be 4-63 characters, and valid characters are /[a-z][0-9]-_/.

Yields
  • (response, operation) — Access the result along with the RPC operation
Yield Parameters
Raises
  • (::Google::Cloud::Error) — if the RPC is aborted.
Example

Basic example

require "google/cloud/retail/v2"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::Retail::V2::ServingConfigService::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::Retail::V2::CreateServingConfigRequest.new

# Call the create_serving_config method.
result = client.create_serving_config request

# The returned object is of type Google::Cloud::Retail::V2::ServingConfig.
p result

#delete_serving_config

def delete_serving_config(request, options = nil) -> ::Google::Protobuf::Empty
def delete_serving_config(name: nil) -> ::Google::Protobuf::Empty

Deletes a ServingConfig.

Returns a NotFound error if the ServingConfig does not exist.

Overloads
def delete_serving_config(request, options = nil) -> ::Google::Protobuf::Empty
Pass arguments to delete_serving_config via a request object, either of type DeleteServingConfigRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::Retail::V2::DeleteServingConfigRequest, ::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.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
def delete_serving_config(name: nil) -> ::Google::Protobuf::Empty
Pass arguments to delete_serving_config 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).
Parameter
  • name (::String) — Required. The resource name of the ServingConfig to delete. Format: projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/servingConfigs/{serving_config_id}
Yields
  • (response, operation) — Access the result along with the RPC operation
Yield Parameters
Raises
  • (::Google::Cloud::Error) — if the RPC is aborted.
Example

Basic example

require "google/cloud/retail/v2"

# Create a client object. The client can be reused for multiple calls.
client = Go