Google Cloud Retail V2 Client - Class UserEventServiceClient (2.3.0)

 use Google\ApiCore\ApiException;
use Google\Api\HttpBody;
use Google\Cloud\Retail\V2\Client\UserEventServiceClient;
use Google\Cloud\Retail\V2\CollectUserEventRequest;

/**
 * @param string $parent    The parent catalog name, such as
 *                          `projects/1234/locations/global/catalogs/default_catalog`.
 * @param string $userEvent URL encoded UserEvent proto with a length limit of 2,000,000
 *                          characters.
 */
function collect_user_event_sample(string $parent, string $userEvent): void
{
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $request = (new CollectUserEventRequest())
        ->setParent($parent)
        ->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
{
    $parent = '[PARENT]';
    $userEvent = '[USER_EVENT]';

    collect_user_event_sample($parent, $userEvent);
} 

 use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Retail\V2\Client\UserEventServiceClient;
use Google\Cloud\Retail\V2\ImportUserEventsRequest;
use Google\Cloud\Retail\V2\ImportUserEventsResponse;
use Google\Cloud\Retail\V2\UserEvent;
use Google\Cloud\Retail\V2\UserEventInlineSource;
use Google\Cloud\Retail\V2\UserEventInputConfig;
use Google\Rpc\Status;

/**
 * @param string $formattedParent                                     `projects/1234/locations/global/catalogs/default_catalog`
 *                                                                    Please see {@see UserEventServiceClient::catalogName()} for help formatting this field.
 * @param string $inputConfigUserEventInlineSourceUserEventsEventType User event type. Allowed values are:
 *
 *                                                                    * `add-to-cart`: Products being added to cart.
 *                                                                    * `remove-from-cart`: Products being removed from cart.
 *                                                                    * `category-page-view`: Special pages such as sale or promotion pages
 *                                                                    viewed.
 *                                                                    * `detail-page-view`: Products detail page viewed.
 *                                                                    * `home-page-view`: Homepage viewed.
 *                                                                    * `purchase-complete`: User finishing a purchase.
 *                                                                    * `search`: Product search.
 *                                                                    * `shopping-cart-page-view`: User viewing a shopping cart.
 * @param string $inputConfigUserEventInlineSourceUserEventsVisitorId A unique identifier for tracking visitors.
 *
 *                                                                    For example, this could be implemented with an 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.
 *
 *                                                                    Don't set the field to the same fixed ID for different users. This mixes
 *                                                                    the event history of those users together, which results in degraded model
 *                                                                    quality.
 *
 *                                                                    The field must be a UTF-8 encoded string with a length limit of 128
 *                                                                    characters. Otherwise, an INVALID_ARGUMENT error is returned.
 *
 *                                                                    The field should not contain PII or user-data. We recommend to use Google
 *                                                                    Analytics [Client
 *                                                                    ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId)
 *                                                                    for this field.
 */
function import_user_events_sample(
    string $formattedParent,
    string $inputConfigUserEventInlineSourceUserEventsEventType,
    string $inputConfigUserEventInlineSourceUserEventsVisitorId
): void {
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $userEvent = (new UserEvent())
        ->setEventType($inputConfigUserEventInlineSourceUserEventsEventType)
        ->setVisitorId($inputConfigUserEventInlineSourceUserEventsVisitorId);
    $inputConfigUserEventInlineSourceUserEvents = [$userEvent,];
    $inputConfigUserEventInlineSource = (new UserEventInlineSource())
        ->setUserEvents($inputConfigUserEventInlineSourceUserEvents);
    $inputConfig = (new UserEventInputConfig())
        ->setUserEventInlineSource($inputConfigUserEventInlineSource);
    $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::catalogName('[PROJECT]', '[LOCATION]', '[CATALOG]');
    $inputConfigUserEventInlineSourceUserEventsEventType = '[EVENT_TYPE]';
    $inputConfigUserEventInlineSourceUserEventsVisitorId = '[VISITOR_ID]';

    import_user_events_sample(
        $formattedParent,
        $inputConfigUserEventInlineSourceUserEventsEventType,
        $inputConfigUserEventInlineSourceUserEventsVisitorId
    );
} 

 use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Retail\V2\Client\UserEventServiceClient;
use Google\Cloud\Retail\V2\PurgeUserEventsRequest;
use Google\Cloud\Retail\V2\PurgeUserEventsResponse;
use Google\Rpc\Status;

/**
 * @param string $formattedParent The resource name of the catalog under which the events are
 *                                created. The format is
 *                                `projects/${projectId}/locations/global/catalogs/${catalogId}`
 *                                Please see {@see UserEventServiceClient::catalogName()} for help formatting this field.
 * @param string $filter          The filter string to specify the events to be deleted with a
 *                                length limit of 5,000 characters. Empty string filter is not allowed. The
 *                                eligible fields for filtering are:
 *
 *                                * `eventType`: Double quoted
 *                                [UserEvent.event_type][google.cloud.retail.v2.UserEvent.event_type] string.
 *                                * `eventTime`: in ISO 8601 "zulu" format.
 *                                * `visitorId`: Double quoted string. Specifying this will delete all
 *                                events associated with a visitor.
 *                                * `userId`: Double quoted string. Specifying this will delete all events
 *                                associated with a user.
 *
 *                                Examples:
 *
 *                                * Deleting all events in a time range:
 *                                `eventTime > "2012-04-23T18:25:43.511Z"
 *                                eventTime < "2012-04-23T18:30:43.511Z"`
 *                                * Deleting specific eventType in time range:
 *                                `eventTime > "2012-04-23T18:25:43.511Z" eventType = "detail-page-view"`
 *                                * 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::catalogName('[PROJECT]', '[LOCATION]', '[CATALOG]');
    $filter = '[FILTER]';

    purge_user_events_sample($formattedParent, $filter);
} 

 use Google\ApiCore\ApiException;
use Google\ApiCore\OperationResponse;
use Google\Cloud\Retail\V2\Client\UserEventServiceClient;
use Google\Cloud\Retail\V2\RejoinUserEventsRequest;
use Google\Cloud\Retail\V2\RejoinUserEventsResponse;
use Google\Rpc\Status;

/**
 * @param string $parent The parent catalog resource name, such as
 *                       `projects/1234/locations/global/catalogs/default_catalog`.
 */
function rejoin_user_events_sample(string $parent): void
{
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $request = (new RejoinUserEventsRequest())
        ->setParent($parent);

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

        if ($response->operationSucceeded()) {
            /** @var RejoinUserEventsResponse $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
{
    $parent = '[PARENT]';

    rejoin_user_events_sample($parent);
} 

 use Google\ApiCore\ApiException;
use Google\Cloud\Retail\V2\Client\UserEventServiceClient;
use Google\Cloud\Retail\V2\UserEvent;
use Google\Cloud\Retail\V2\WriteUserEventRequest;

/**
 * @param string $parent             The parent catalog resource name, such as
 *                                   `projects/1234/locations/global/catalogs/default_catalog`.
 * @param string $userEventEventType User event type. Allowed values are:
 *
 *                                   * `add-to-cart`: Products being added to cart.
 *                                   * `remove-from-cart`: Products being removed from cart.
 *                                   * `category-page-view`: Special pages such as sale or promotion pages
 *                                   viewed.
 *                                   * `detail-page-view`: Products detail page viewed.
 *                                   * `home-page-view`: Homepage viewed.
 *                                   * `purchase-complete`: User finishing a purchase.
 *                                   * `search`: Product search.
 *                                   * `shopping-cart-page-view`: User viewing a shopping cart.
 * @param string $userEventVisitorId A unique identifier for tracking visitors.
 *
 *                                   For example, this could be implemented with an 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.
 *
 *                                   Don't set the field to the same fixed ID for different users. This mixes
 *                                   the event history of those users together, which results in degraded model
 *                                   quality.
 *
 *                                   The field must be a UTF-8 encoded string with a length limit of 128
 *                                   characters. Otherwise, an INVALID_ARGUMENT error is returned.
 *
 *                                   The field should not contain PII or user-data. We recommend to use Google
 *                                   Analytics [Client
 *                                   ID](https://developers.google.com/analytics/devguides/collection/analyticsjs/field-reference#clientId)
 *                                   for this field.
 */
function write_user_event_sample(
    string $parent,
    string $userEventEventType,
    string $userEventVisitorId
): void {
    // Create a client.
    $userEventServiceClient = new UserEventServiceClient();

    // Prepare the request message.
    $userEvent = (new UserEvent())
        ->setEventType($userEventEventType)
        ->setVisitorId($userEventVisitorId);
    $request = (new WriteUserEventRequest())
        ->setParent($parent)
        ->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
{
    $parent = '[PARENT]';
    $userEventEventType = '[EVENT_TYPE]';
    $userEventVisitorId = '[VISITOR_ID]';

    write_user_event_sample($parent, $userEventEventType, $userEventVisitorId);
}