Class ProductServiceAsyncClient (1.7.0)

Service for ingesting Product information of the customer's website.

Returns the transport used by the client instance.

Instantiates the product service client.

Incrementally adds place IDs to xref_Product.fulfillment_info.place_ids.

This process is asynchronous and does not require the xref_Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the added place IDs are not immediately manifested in the xref_Product queried by xref_GetProduct or xref_ListProducts.

This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.

from google.cloud import retail_v2beta

async def sample_add_fulfillment_places():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.AddFulfillmentPlacesRequest(
        product="product_value",
        type_="type__value",
        place_ids=['place_ids_value_1', 'place_ids_value_2'],
    )

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

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

    response = await operation.result()

    # Handle the response
    print(response)

Updates local inventory information for a xref_Product at a list of places, while respecting the last update timestamps of each inventory field.

This process is asynchronous and does not require the xref_Product to exist before updating inventory information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the xref_Product queried by xref_GetProduct or xref_ListProducts.

Local inventory information can only be modified using this method. xref_CreateProduct and xref_UpdateProduct has no effect on local inventories.

This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.

from google.cloud import retail_v2beta

async def sample_add_local_inventories():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.AddLocalInventoriesRequest(
        product="product_value",
    )

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

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

    response = await operation.result()

    # Handle the response
    print(response)

Returns a fully-qualified branch string.

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 a xref_Product.

from google.cloud import retail_v2beta

async def sample_create_product():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    product = retail_v2beta.Product()
    product.title = "title_value"

    request = retail_v2beta.CreateProductRequest(
        parent="parent_value",
        product=product,
        product_id="product_id_value",
    )

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

    # Handle the response
    print(response)

Deletes a xref_Product.

from google.cloud import retail_v2beta

async def sample_delete_product():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.DeleteProductRequest(
        name="name_value",
    )

    # Make the request
    await client.delete_product(request=request)

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.

Gets a xref_Product.

from google.cloud import retail_v2beta

async def sample_get_product():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.GetProductRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)

Returns an appropriate transport class.

Bulk import of multiple xref_Products.

Request processing may be synchronous. No partial updating is supported. Non-existing items are created.

Note that it is possible for a subset of the xref_Products to be successfully updated.

from google.cloud import retail_v2beta

async def sample_import_products():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    input_config = retail_v2beta.ProductInputConfig()
    input_config.product_inline_source.products.title = "title_value"

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

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

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

    response = await operation.result()

    # Handle the response
    print(response)

Gets a list of xref_Products.

from google.cloud import retail_v2beta

async def sample_list_products():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

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

    # Make the request
    page_result = client.list_products(request=request)

    # Handle the response
    async for response in page_result:
        print(response)

Parses a branch 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.

Incrementally removes place IDs from a xref_Product.fulfillment_info.place_ids.

This process is asynchronous and does not require the xref_Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, the removed place IDs are not immediately manifested in the xref_Product queried by xref_GetProduct or xref_ListProducts.

This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.

from google.cloud import retail_v2beta

async def sample_remove_fulfillment_places():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.RemoveFulfillmentPlacesRequest(
        product="product_value",
        type_="type__value",
        place_ids=['place_ids_value_1', 'place_ids_value_2'],
    )

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

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

    response = await operation.result()

    # Handle the response
    print(response)

Remove local inventory information for a xref_Product at a list of places at a removal timestamp.

This process is asynchronous. If the request is valid, the removal will be enqueued and processed downstream. As a consequence, when a response is returned, removals are not immediately manifested in the xref_Product queried by xref_GetProduct or xref_ListProducts.

Local inventory information can only be removed using this method. xref_CreateProduct and xref_UpdateProduct has no effect on local inventories.

This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.

from google.cloud import retail_v2beta

async def sample_remove_local_inventories():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    request = retail_v2beta.RemoveLocalInventoriesRequest(
        product="product_value",
        place_ids=['place_ids_value_1', 'place_ids_value_2'],
    )

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

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

    response = await operation.result()

    # Handle the response
    print(response)

Updates inventory information for a xref_Product while respecting the last update timestamps of each inventory field.

This process is asynchronous and does not require the xref_Product to exist before updating fulfillment information. If the request is valid, the update will be enqueued and processed downstream. As a consequence, when a response is returned, updates are not immediately manifested in the xref_Product queried by xref_GetProduct or xref_ListProducts.

When inventory is updated with xref_CreateProduct and xref_UpdateProduct, the specified inventory field value(s) will overwrite any existing value(s) while ignoring the last update time for this field. Furthermore, the last update time for the specified inventory fields will be overwritten to the time of the xref_CreateProduct or xref_UpdateProduct request.

If no inventory fields are set in xref_CreateProductRequest.product, then any pre-existing inventory information for this product will be used.

If no inventory fields are set in xref_SetInventoryRequest.set_mask, then any existing inventory information will be preserved.

Pre-existing inventory information can only be updated with xref_SetInventory, xref_AddFulfillmentPlaces, and xref_RemoveFulfillmentPlaces.

This feature is only available for users who have Retail Search enabled. Please enable Retail Search on Cloud Console before using this feature.

from google.cloud import retail_v2beta

async def sample_set_inventory():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    inventory = retail_v2beta.Product()
    inventory.title = "title_value"

    request = retail_v2beta.SetInventoryRequest(
        inventory=inventory,
    )

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

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

    response = await operation.result()

    # Handle the response
    print(response)

Updates a xref_Product.

from google.cloud import retail_v2beta

async def sample_update_product():
    # Create a client
    client = retail_v2beta.ProductServiceAsyncClient()

    # Initialize request argument(s)
    product = retail_v2beta.Product()
    product.title = "title_value"

    request = retail_v2beta.UpdateProductRequest(
        product=product,
    )

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

    # Handle the response
    print(response)