class Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Client

Client for the UserEventService service.

Service for ingesting end user actions on the customer website.

Attributes

operations_client[R]

Get the associated client for long-running operations.

@return [::Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Operations]

user_event_service_stub[R]

@private

Public Class Methods

configure() { |configure| ... } click to toggle source

Configure the UserEventService Client class.

See {::Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Client::Configuration} for a description of the configuration fields.

@example

# Modify the configuration for all UserEventService clients
::Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Client.configure do |config|
  config.timeout = 10.0
end

@yield [config] Configure the Client client. @yieldparam config [Client::Configuration]

@return [Client::Configuration]

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 56
def self.configure
  @configure ||= begin
    namespace = ["Google", "Cloud", "RecommendationEngine", "V1beta1"]
    parent_config = while namespace.any?
                      parent_name = namespace.join "::"
                      parent_const = const_get parent_name
                      break parent_const.configure if parent_const.respond_to? :configure
                      namespace.pop
                    end
    default_config = Client::Configuration.new parent_config

    default_config.rpcs.write_user_event.timeout = 600.0
    default_config.rpcs.write_user_event.retry_policy = {
      initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
    }

    default_config.rpcs.collect_user_event.timeout = 600.0
    default_config.rpcs.collect_user_event.retry_policy = {
      initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
    }

    default_config.rpcs.list_user_events.timeout = 600.0
    default_config.rpcs.list_user_events.retry_policy = {
      initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
    }

    default_config.rpcs.purge_user_events.timeout = 600.0
    default_config.rpcs.purge_user_events.retry_policy = {
      initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
    }

    default_config.rpcs.import_user_events.timeout = 600.0
    default_config.rpcs.import_user_events.retry_policy = {
      initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 4]
    }

    default_config
  end
  yield @configure if block_given?
  @configure
end
new() { |config| ... } click to toggle source

Create a new UserEventService client object.

@example

# Create a client using the default configuration
client = ::Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Client.new

# Create a client using a custom configuration
client = ::Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Client.new do |config|
  config.timeout = 10.0
end

@yield [config] Configure the UserEventService client. @yieldparam config [Client::Configuration]

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 134
def initialize
  # These require statements are intentionally placed here to initialize
  # the gRPC module only when it's required.
  # See https://github.com/googleapis/toolkit/issues/446
  require "gapic/grpc"
  require "google/cloud/recommendationengine/v1beta1/user_event_service_services_pb"

  # Create the configuration object
  @config = Configuration.new Client.configure

  # Yield the configuration if needed
  yield @config if block_given?

  # Create credentials
  credentials = @config.credentials
  # Use self-signed JWT if the endpoint is unchanged from default,
  # but only if the default endpoint does not have a region prefix.
  enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
                           !@config.endpoint.split(".").first.include?("-")
  credentials ||= Credentials.default scope: @config.scope,
                                      enable_self_signed_jwt: enable_self_signed_jwt
  if credentials.is_a?(::String) || credentials.is_a?(::Hash)
    credentials = Credentials.new credentials, scope: @config.scope
  end
  @quota_project_id = @config.quota_project
  @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id

  @operations_client = Operations.new do |config|
    config.credentials = credentials
    config.endpoint = @config.endpoint
  end

  @user_event_service_stub = ::Gapic::ServiceStub.new(
    ::Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Stub,
    credentials:  credentials,
    endpoint:     @config.endpoint,
    channel_args: @config.channel_args,
    interceptors: @config.interceptors
  )
end

Public Instance Methods

collect_user_event(request, options = nil) { |response, operation| ... } click to toggle source

Writes a single user event from the browser. This uses a GET request to due to browser restriction of POST-ing to a 3rd party domain.

This method is used only by the Recommendations AI JavaScript pixel. Users should not call this method directly.

@overload collect_user_event(request, options = nil)

Pass arguments to `collect_user_event` via a request object, either of type
{::Google::Cloud::RecommendationEngine::V1beta1::CollectUserEventRequest} or an equivalent Hash.

@param request [::Google::Cloud::RecommendationEngine::V1beta1::CollectUserEventRequest, ::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.

@overload collect_user_event(parent: nil, user_event: nil, uri: nil, ets: nil)

Pass arguments to `collect_user_event` 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).

@param parent [::String]
  Required. The parent eventStore name, such as
  `projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store`.
@param user_event [::String]
  Required. URL encoded UserEvent proto.
@param uri [::String]
  Optional. The url including cgi-parameters but excluding the hash fragment.
  The URL must be truncated to 1.5K bytes to conservatively be under the 2K
  bytes. This is often more useful than the referer url, because many
  browsers only send the domain for 3rd party requests.
@param ets [::Integer]
  Optional. The event timestamp in milliseconds. This prevents browser
  caching of otherwise identical get requests. The name is abbreviated to
  reduce the payload bytes.

@yield [response, operation] Access the result along with the RPC operation @yieldparam response [::Google::Api::HttpBody] @yieldparam operation [::GRPC::ActiveCall::Operation]

@return [::Google::Api::HttpBody]

@raise [::Google::Cloud::Error] if the RPC is aborted.

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 300
def collect_user_event request, options = nil
  raise ::ArgumentError, "request must be provided" if request.nil?

  request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::RecommendationEngine::V1beta1::CollectUserEventRequest

  # 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.collect_user_event.metadata.to_h

  # Set x-goog-api-client and x-goog-user-project 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::Cloud::RecommendationEngine::V1beta1::VERSION
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id

  header_params = {
    "parent" => request.parent
  }
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
  metadata[:"x-goog-request-params"] ||= request_params_header

  options.apply_defaults timeout:      @config.rpcs.collect_user_event.timeout,
                         metadata:     metadata,
                         retry_policy: @config.rpcs.collect_user_event.retry_policy

  options.apply_defaults timeout:      @config.timeout,
                         metadata:     @config.metadata,
                         retry_policy: @config.retry_policy

  @user_event_service_stub.call_rpc :collect_user_event, request, options: options do |response, operation|
    yield response, operation if block_given?
    return response
  end
rescue ::GRPC::BadStatus => e
  raise ::Google::Cloud::Error.from_error(e)
end
configure() { |config| ... } click to toggle source

Configure the UserEventService 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 {::Google::Cloud::RecommendationEngine::V1beta1::UserEventService::Client::Configuration} for a description of the configuration fields.

@yield [config] Configure the Client client. @yieldparam config [Client::Configuration]

@return [Client::Configuration]

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 113
def configure
  yield @config if block_given?
  @config
end
import_user_events(request, options = nil) { |response, operation| ... } click to toggle source

Bulk import of User events. Request processing might be synchronous. Events that already exist are skipped. Use this method for backfilling historical user events.

Operation.response is of type ImportResponse. Note that it is possible for a subset of the items to be successfully inserted. Operation.metadata is of type ImportMetadata.

@overload import_user_events(request, options = nil)

Pass arguments to `import_user_events` via a request object, either of type
{::Google::Cloud::RecommendationEngine::V1beta1::ImportUserEventsRequest} or an equivalent Hash.

@param request [::Google::Cloud::RecommendationEngine::V1beta1::ImportUserEventsRequest, ::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.

@overload import_user_events(parent: nil, request_id: nil, input_config: nil, errors_config: nil)

Pass arguments to `import_user_events` 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).

@param parent [::String]
  Required.
  `projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store`
@param request_id [::String]
  Optional. Unique identifier provided by client, within the ancestor
  dataset scope. Ensures idempotency for expensive long running operations.
  Server-generated if unspecified. Up to 128 characters long. This is
  returned as google.longrunning.Operation.name in the response. Note that
  this field must not be set if the desired input config is
  catalog_inline_source.
@param input_config [::Google::Cloud::RecommendationEngine::V1beta1::InputConfig, ::Hash]
  Required. The desired input location of the data.
@param errors_config [::Google::Cloud::RecommendationEngine::V1beta1::ImportErrorsConfig, ::Hash]
  Optional. The desired location of errors incurred during the Import.

@yield [response, operation] Access the result along with the RPC operation @yieldparam response [::Gapic::Operation] @yieldparam operation [::GRPC::ActiveCall::Operation]

@return [::Gapic::Operation]

@raise [::Google::Cloud::Error] if the RPC is aborted.

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 591
def import_user_events request, options = nil
  raise ::ArgumentError, "request must be provided" if request.nil?

  request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::RecommendationEngine::V1beta1::ImportUserEventsRequest

  # 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.import_user_events.metadata.to_h

  # Set x-goog-api-client and x-goog-user-project 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::Cloud::RecommendationEngine::V1beta1::VERSION
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id

  header_params = {
    "parent" => request.parent
  }
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
  metadata[:"x-goog-request-params"] ||= request_params_header

  options.apply_defaults timeout:      @config.rpcs.import_user_events.timeout,
                         metadata:     metadata,
                         retry_policy: @config.rpcs.import_user_events.retry_policy

  options.apply_defaults timeout:      @config.timeout,
                         metadata:     @config.metadata,
                         retry_policy: @config.retry_policy

  @user_event_service_stub.call_rpc :import_user_events, request, options: options do |response, operation|
    response = ::Gapic::Operation.new response, @operations_client, options: options
    yield response, operation if block_given?
    return response
  end
rescue ::GRPC::BadStatus => e
  raise ::Google::Cloud::Error.from_error(e)
end
list_user_events(request, options = nil) { |response, operation| ... } click to toggle source

Gets a list of user events within a time range, with potential filtering.

@overload list_user_events(request, options = nil)

Pass arguments to `list_user_events` via a request object, either of type
{::Google::Cloud::RecommendationEngine::V1beta1::ListUserEventsRequest} or an equivalent Hash.

@param request [::Google::Cloud::RecommendationEngine::V1beta1::ListUserEventsRequest, ::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.

@overload list_user_events(parent: nil, page_size: nil, page_token: nil, filter: nil)

Pass arguments to `list_user_events` 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).

@param parent [::String]
  Required. The parent eventStore resource name, such as
  `projects/*/locations/*/catalogs/default_catalog/eventStores/default_event_store`.
@param page_size [::Integer]
  Optional. Maximum number of results to return per page. If zero, the
  service will choose a reasonable default.
@param page_token [::String]
  Optional. The previous ListUserEventsResponse.next_page_token.
@param filter [::String]
  Optional. Filtering expression to specify restrictions over
  returned events. This is a sequence of terms, where each term applies some
  kind of a restriction to the returned user events. Use this expression to
  restrict results to a specific time range, or filter events by eventType.
     eg: eventTime > "2012-04-23T18:25:43.511Z" eventsMissingCatalogItems
     eventTime<"2012-04-23T18:25:43.511Z" eventType=search

    We expect only 3 types of fields:

     * eventTime: this can be specified a maximum of 2 times, once with a
       less than operator and once with a greater than operator. The
       eventTime restrict should result in one contiguous valid eventTime
       range.

     * eventType: only 1 eventType restriction can be specified.

     * eventsMissingCatalogItems: specififying this will restrict results
       to events for which catalog items were not found in the catalog. The
       default behavior is to return only those events for which catalog
       items were found.

    Some examples of valid filters expressions:

    * Example 1: eventTime > "2012-04-23T18:25:43.511Z"
              eventTime < "2012-04-23T18:30:43.511Z"
    * Example 2: eventTime > "2012-04-23T18:25:43.511Z"
              eventType = detail-page-view
    * Example 3: eventsMissingCatalogItems
              eventType = search eventTime < "2018-04-23T18:30:43.511Z"
    * Example 4: eventTime > "2012-04-23T18:25:43.511Z"
    * Example 5: eventType = search
    * Example 6: eventsMissingCatalogItems

@yield [response, operation] Access the result along with the RPC operation @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::RecommendationEngine::V1beta1::UserEvent>] @yieldparam operation [::GRPC::ActiveCall::Operation]

@return [::Gapic::PagedEnumerable<::Google::Cloud::RecommendationEngine::V1beta1::UserEvent>]

@raise [::Google::Cloud::Error] if the RPC is aborted.

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 407
def list_user_events request, options = nil
  raise ::ArgumentError, "request must be provided" if request.nil?

  request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::RecommendationEngine::V1beta1::ListUserEventsRequest

  # 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.list_user_events.metadata.to_h

  # Set x-goog-api-client and x-goog-user-project 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::Cloud::RecommendationEngine::V1beta1::VERSION
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id

  header_params = {
    "parent" => request.parent
  }
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
  metadata[:"x-goog-request-params"] ||= request_params_header

  options.apply_defaults timeout:      @config.rpcs.list_user_events.timeout,
                         metadata:     metadata,
                         retry_policy: @config.rpcs.list_user_events.retry_policy

  options.apply_defaults timeout:      @config.timeout,
                         metadata:     @config.metadata,
                         retry_policy: @config.retry_policy

  @user_event_service_stub.call_rpc :list_user_events, request, options: options do |response, operation|
    response = ::Gapic::PagedEnumerable.new @user_event_service_stub, :list_user_events, request, response, operation, options
    yield response, operation if block_given?
    return response
  end
rescue ::GRPC::BadStatus => e
  raise ::Google::Cloud::Error.from_error(e)
end
purge_user_events(request, options = nil) { |response, operation| ... } click to toggle source

Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.

@overload purge_user_events(request, options = nil)

Pass arguments to `purge_user_events` via a request object, either of type
{::Google::Cloud::RecommendationEngine::V1beta1::PurgeUserEventsRequest} or an equivalent Hash.

@param request [::Google::Cloud::RecommendationEngine::V1beta1::PurgeUserEventsRequest, ::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.

@overload purge_user_events(parent: nil, filter: nil, force: nil)

Pass arguments to `purge_user_events` 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).

@param parent [::String]
  Required. The resource name of the event_store under which the events are
  created. The format is
  `projects/${projectId}/locations/global/catalogs/${catalogId}/eventStores/${eventStoreId}`
@param filter [::String]
  Required. The filter string to specify the events to be deleted. Empty
  string filter is not allowed. This filter can also be used with
  ListUserEvents API to list events that will be deleted. The eligible fields
  for filtering are:
  * eventType - UserEvent.eventType field of type string.
  * eventTime - in ISO 8601 "zulu" format.
  * visitorId - field of type string. Specifying this will delete all events
  associated with a visitor.
  * userId - field of type string. Specifying this will delete all events
  associated with a user.
  Example 1: Deleting all events in a time range.
  `eventTime > "2012-04-23T18:25:43.511Z" eventTime <
  "2012-04-23T18:30:43.511Z"`
  Example 2: Deleting specific eventType in time range.
  `eventTime > "2012-04-23T18:25:43.511Z" eventType = "detail-page-view"`
  Example 3: Deleting all events for a specific visitor
  `visitorId = visitor1024`
  The filtering fields are assumed to have an implicit AND.
@param force [::Boolean]
  Optional. The default value is false. Override this flag to true to
  actually perform the purge. If the field is not set to true, a sampling of
  events to be deleted will be returned.

@yield [response, operation] Access the result along with the RPC operation @yieldparam response [::Gapic::Operation] @yieldparam operation [::GRPC::ActiveCall::Operation]

@return [::Gapic::Operation]

@raise [::Google::Cloud::Error] if the RPC is aborted.

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 504
def purge_user_events request, options = nil
  raise ::ArgumentError, "request must be provided" if request.nil?

  request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::RecommendationEngine::V1beta1::PurgeUserEventsRequest

  # 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.purge_user_events.metadata.to_h

  # Set x-goog-api-client and x-goog-user-project 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::Cloud::RecommendationEngine::V1beta1::VERSION
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id

  header_params = {
    "parent" => request.parent
  }
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
  metadata[:"x-goog-request-params"] ||= request_params_header

  options.apply_defaults timeout:      @config.rpcs.purge_user_events.timeout,
                         metadata:     metadata,
                         retry_policy: @config.rpcs.purge_user_events.retry_policy

  options.apply_defaults timeout:      @config.timeout,
                         metadata:     @config.metadata,
                         retry_policy: @config.retry_policy

  @user_event_service_stub.call_rpc :purge_user_events, request, options: options do |response, operation|
    response = ::Gapic::Operation.new response, @operations_client, options: options
    yield response, operation if block_given?
    return response
  end
rescue ::GRPC::BadStatus => e
  raise ::Google::Cloud::Error.from_error(e)
end
write_user_event(request, options = nil) { |response, operation| ... } click to toggle source

Writes a single user event.

@overload write_user_event(request, options = nil)

Pass arguments to `write_user_event` via a request object, either of type
{::Google::Cloud::RecommendationEngine::V1beta1::WriteUserEventRequest} or an equivalent Hash.

@param request [::Google::Cloud::RecommendationEngine::V1beta1::WriteUserEventRequest, ::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.

@overload write_user_event(parent: nil, user_event: nil)

Pass arguments to `write_user_event` 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).

@param parent [::String]
  Required. The parent eventStore resource name, such as
  `projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store`.
@param user_event [::Google::Cloud::RecommendationEngine::V1beta1::UserEvent, ::Hash]
  Required. User event to write.

@yield [response, operation] Access the result along with the RPC operation @yieldparam response [::Google::Cloud::RecommendationEngine::V1beta1::UserEvent] @yieldparam operation [::GRPC::ActiveCall::Operation]

@return [::Google::Cloud::RecommendationEngine::V1beta1::UserEvent]

@raise [::Google::Cloud::Error] if the RPC is aborted.

# File lib/google/cloud/recommendation_engine/v1beta1/user_event_service/client.rb, line 216
def write_user_event request, options = nil
  raise ::ArgumentError, "request must be provided" if request.nil?

  request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::RecommendationEngine::V1beta1::WriteUserEventRequest

  # 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.write_user_event.metadata.to_h

  # Set x-goog-api-client and x-goog-user-project 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::Cloud::RecommendationEngine::V1beta1::VERSION
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id

  header_params = {
    "parent" => request.parent
  }
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
  metadata[:"x-goog-request-params"] ||= request_params_header

  options.apply_defaults timeout:      @config.rpcs.write_user_event.timeout,
                         metadata:     metadata,
                         retry_policy: @config.rpcs.write_user_event.retry_policy

  options.apply_defaults timeout:      @config.timeout,
                         metadata:     @config.metadata,
                         retry_policy: @config.retry_policy

  @user_event_service_stub.call_rpc :write_user_event, request, options: options do |response, operation|
    yield response, operation if block_given?
    return response
  end
rescue ::GRPC::BadStatus => e
  raise ::Google::Cloud::Error.from_error(e)
end