Google Cloud Recommendation Engine V1beta1 Client - Class UserEventServiceClient (0.6.4)

Namespace

Methods

__construct

collectUserEvent

use Google\ApiCore\ApiException;
use Google\Api\HttpBody;
use Google\Cloud\RecommendationEngine\V1beta1\Client\UserEventServiceClient;
use Google\Cloud\RecommendationEngine\V1beta1\CollectUserEventRequest;

/**
 * @param string $formattedParent The parent eventStore name, such as
 *                                `projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store`. Please see
 *                                {@see UserEventServiceClient::eventStoreName()} for help formatting this field.
 * @param string $userEvent       URL encoded UserEvent proto.
 */
function collect_user_event_sample(string $formattedParent, string $userEvent): void
{
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $request = (new CollectUserEventRequest())
        ->setParent($formattedParent)
        ->setUserEvent($userEvent);

    // Call the API and handle any network failures.
    try {
        /** @var HttpBody $response */
        $response = $userEventServiceClient->collectUserEvent($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample 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,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = UserEventServiceClient::eventStoreName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]',
        '[EVENT_STORE]'
    );
    $userEvent = '[USER_EVENT]';

    collect_user_event_sample($formattedParent, $userEvent);
}

importUserEvents

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\RecommendationEngine\V1beta1\Client\UserEventServiceClient;
use Google\Cloud\RecommendationEngine\V1beta1\ImportUserEventsRequest;
use Google\Cloud\RecommendationEngine\V1beta1\ImportUserEventsResponse;
use Google\Cloud\RecommendationEngine\V1beta1\InputConfig;
use Google\Rpc\Status;

/**
 * @param string $formattedParent Required.
 *                                `projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store`
 *                                Please see {@see UserEventServiceClient::eventStoreName()} for help formatting this field.
 */
function import_user_events_sample(string $formattedParent): void
{
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $inputConfig = new InputConfig();
    $request = (new ImportUserEventsRequest())
        ->setParent($formattedParent)
        ->setInputConfig($inputConfig);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $userEventServiceClient->importUserEvents($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            /** @var ImportUserEventsResponse $result */
            $result = $response->getResult();
            printf('Operation successful with response data: %s' . PHP_EOL, $result->serializeToJsonString());
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample 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,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = UserEventServiceClient::eventStoreName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]',
        '[EVENT_STORE]'
    );

    import_user_events_sample($formattedParent);
}

listUserEvents

use Google\ApiCore\ApiException;
use Google\ApiCore\PagedListResponse;
use Google\Cloud\RecommendationEngine\V1beta1\Client\UserEventServiceClient;
use Google\Cloud\RecommendationEngine\V1beta1\ListUserEventsRequest;
use Google\Cloud\RecommendationEngine\V1beta1\UserEvent;

/**
 * @param string $formattedParent The parent eventStore resource name, such as
 *                                `projects/*/locations/*/catalogs/default_catalog/eventStores/default_event_store`. Please see
 *                                {@see UserEventServiceClient::eventStoreName()} for help formatting this field.
 */
function list_user_events_sample(string $formattedParent): void
{
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $request = (new ListUserEventsRequest())
        ->setParent($formattedParent);

    // Call the API and handle any network failures.
    try {
        /** @var PagedListResponse $response */
        $response = $userEventServiceClient->listUserEvents($request);

        /** @var UserEvent $element */
        foreach ($response as $element) {
            printf('Element data: %s' . PHP_EOL, $element->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample 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,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = UserEventServiceClient::eventStoreName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]',
        '[EVENT_STORE]'
    );

    list_user_events_sample($formattedParent);
}

purgeUserEvents

use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\RecommendationEngine\V1beta1\Client\UserEventServiceClient;
use Google\Cloud\RecommendationEngine\V1beta1\PurgeUserEventsRequest;
use Google\Cloud\RecommendationEngine\V1beta1\PurgeUserEventsResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedParent The resource name of the event_store under which the events are
 *                                created. The format is
 *                                `projects/${projectId}/locations/global/catalogs/${catalogId}/eventStores/${eventStoreId}`
 *                                Please see {@see UserEventServiceClient::eventStoreName()} for help formatting this field.
 * @param string $filter          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.
 */
function purge_user_events_sample(string $formattedParent, string $filter): void
{
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $request = (new PurgeUserEventsRequest())
        ->setParent($formattedParent)
        ->setFilter($filter);

    // Call the API and handle any network failures.
    try {
        /** @var OperationResponse $response */
        $response = $userEventServiceClient->purgeUserEvents($request);
        $response->pollUntilComplete();

        if ($response->operationSucceeded()) {
            /** @var PurgeUserEventsResponse $result */
            $result = $response->getResult();
            printf('Operation successful with response data: %s' . PHP_EOL, $result->serializeToJsonString());
        } else {
            /** @var Status $error */
            $error = $response->getError();
            printf('Operation failed with error data: %s' . PHP_EOL, $error->serializeToJsonString());
        }
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample 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,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = UserEventServiceClient::eventStoreName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]',
        '[EVENT_STORE]'
    );
    $filter = '[FILTER]';

    purge_user_events_sample($formattedParent, $filter);
}

writeUserEvent

use Google\ApiCore\ApiException;
use Google\Cloud\RecommendationEngine\V1beta1\Client\UserEventServiceClient;
use Google\Cloud\RecommendationEngine\V1beta1\UserEvent;
use Google\Cloud\RecommendationEngine\V1beta1\UserInfo;
use Google\Cloud\RecommendationEngine\V1beta1\WriteUserEventRequest;

/**
 * @param string $formattedParent            The parent eventStore resource name, such as
 *                                           `projects/1234/locations/global/catalogs/default_catalog/eventStores/default_event_store`. Please see
 *                                           {@see UserEventServiceClient::eventStoreName()} for help formatting this field.
 * @param string $userEventEventType         User event type. Allowed values are:
 *
 *                                           * `add-to-cart` Products being added to cart.
 *                                           * `add-to-list` Items being added to a list (shopping list, favorites
 *                                           etc).
 *                                           * `category-page-view` Special pages such as sale or promotion pages
 *                                           viewed.
 *                                           * `checkout-start` User starting a checkout process.
 *                                           * `detail-page-view` Products detail page viewed.
 *                                           * `home-page-view` Homepage viewed.
 *                                           * `page-visit` Generic page visits not included in the event types above.
 *                                           * `purchase-complete` User finishing a purchase.
 *                                           * `refund` Purchased items being refunded or returned.
 *                                           * `remove-from-cart` Products being removed from cart.
 *                                           * `remove-from-list` Items being removed from a list.
 *                                           * `search` Product search.
 *                                           * `shopping-cart-page-view` User viewing a shopping cart.
 *                                           * `impression` List of items displayed. Used by Google Tag Manager.
 * @param string $userEventUserInfoVisitorId A unique identifier for tracking visitors with a length limit of
 *                                           128 bytes.
 *
 *                                           For example, this could be implemented with a http cookie, which should be
 *                                           able to uniquely identify a visitor on a single device. This unique
 *                                           identifier should not change if the visitor log in/out of the website.
 *                                           Maximum length 128 bytes. Cannot be empty.
 */
function write_user_event_sample(
    string $formattedParent,
    string $userEventEventType,
    string $userEventUserInfoVisitorId
): void {
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $userEventUserInfo = (new UserInfo())
        ->setVisitorId($userEventUserInfoVisitorId);
    $userEvent = (new UserEvent())
        ->setEventType($userEventEventType)
        ->setUserInfo($userEventUserInfo);
    $request = (new WriteUserEventRequest())
        ->setParent($formattedParent)
        ->setUserEvent($userEvent);

    // Call the API and handle any network failures.
    try {
        /** @var UserEvent $response */
        $response = $userEventServiceClient->writeUserEvent($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 * This sample 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,
 *    please see the apiEndpoint client configuration option for more details.
 */
function callSample(): void
{
    $formattedParent = UserEventServiceClient::eventStoreName(
        '[PROJECT]',
        '[LOCATION]',
        '[CATALOG]',
        '[EVENT_STORE]'
    );
    $userEventEventType = '[EVENT_TYPE]';
    $userEventUserInfoVisitorId = '[VISITOR_ID]';

    write_user_event_sample($formattedParent, $userEventEventType, $userEventUserInfoVisitorId);
}

collectUserEventAsync

importUserEventsAsync

listUserEventsAsync

purgeUserEventsAsync

writeUserEventAsync

getOperationsClient

resumeOperation

static::eventStoreName

static::parseName