Class UserEventServiceAsyncClient (1.10.2)

Service for ingesting end user actions on the customer website.

Returns the transport used by the client instance.

Instantiates the user event service client.

Returns a fully-qualified catalog string.

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 Retail API JavaScript pixel and Google Tag Manager. Users should not call this method directly.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import retail_v2beta

async def sample_collect_user_event():
    # Create a client
    client = retail_v2beta.UserEventServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.CollectUserEventRequest(
        parent="parent_value",
        user_event="user_event_value",
    )

    # Make the request
    response = await client.collect_user_event(request=request)

    # Handle the response
    print(response)

Returns a fully-qualified billing_account string.

Returns a fully-qualified folder string.

Returns a fully-qualified location string.

Returns a fully-qualified organization string.

Returns a fully-qualified project string.

Creates an instance of this client using the provided credentials file.

Creates an instance of this client using the provided credentials info.

Creates an instance of this client using the provided credentials file.

Return the API endpoint and client cert source for mutual TLS.

The client cert source is determined in the following order: (1) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is not "true", the client cert source is None. (2) if client_options.client_cert_source is provided, use the provided one; if the default client cert source exists, use the default one; otherwise the client cert source is None.

The API endpoint is determined in the following order: (1) if client_options.api_endpoint if provided, use the provided one. (2) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "always", use the default mTLS endpoint; if the environment variabel is "never", use the default API endpoint; otherwise if client cert source exists, use the default mTLS endpoint, otherwise use the default API endpoint.

More details can be found at https://google.aip.dev/auth/4114.

Returns an appropriate transport class.

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.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import retail_v2beta

async def sample_import_user_events():
    # Create a client
    client = retail_v2beta.UserEventServiceAsyncClient()

    # Initialize request argument(s)
    input_config = retail_v2beta.UserEventInputConfig()
    input_config.user_event_inline_source.user_events.event_type = "event_type_value"
    input_config.user_event_inline_source.user_events.visitor_id = "visitor_id_value"

    request = retail_v2beta.ImportUserEventsRequest(
        parent="parent_value",
        input_config=input_config,
    )

    # Make the request
    operation = client.import_user_events(request=request)

    print("Waiting for operation to complete...")

    response = await operation.result()

    # Handle the response
    print(response)

Parses a catalog path into its component segments.

Parse a billing_account path into its component segments.

Parse a folder path into its component segments.

Parse a location path into its component segments.

Parse a organization path into its component segments.

Parse a project path into its component segments.

Parses a product path into its component segments.

Returns a fully-qualified product string.

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.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import retail_v2beta

async def sample_purge_user_events():
    # Create a client
    client = retail_v2beta.UserEventServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.PurgeUserEventsRequest(
        parent="parent_value",
        filter="filter_value",
    )

    # Make the request
    operation = client.purge_user_events(request=request)

    print("Waiting for operation to complete...")

    response = await operation.result()

    # Handle the response
    print(response)

Starts a user-event rejoin operation with latest product catalog. Events are not annotated with detailed product information for products that are missing from the catalog when the user event is ingested. These events are stored as unjoined events with limited usage on training and serving. You can use this method to start a join operation on specified events with the latest version of product catalog. You can also use this method to correct events joined with the wrong product catalog. A rejoin operation can take hours or days to complete.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import retail_v2beta

async def sample_rejoin_user_events():
    # Create a client
    client = retail_v2beta.UserEventServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.RejoinUserEventsRequest(
        parent="parent_value",
    )

    # Make the request
    operation = client.rejoin_user_events(request=request)

    print("Waiting for operation to complete...")

    response = await operation.result()

    # Handle the response
    print(response)

Writes a single user event.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import retail_v2beta

async def sample_write_user_event():
    # Create a client
    client = retail_v2beta.UserEventServiceAsyncClient()

    # Initialize request argument(s)
    user_event = retail_v2beta.UserEvent()
    user_event.event_type = "event_type_value"
    user_event.visitor_id = "visitor_id_value"

    request = retail_v2beta.WriteUserEventRequest(
        parent="parent_value",
        user_event=user_event,
    )

    # Make the request
    response = await client.write_user_event(request=request)

    # Handle the response
    print(response)