def list_user_events(self, request: Union[(user_event_service.ListUserEventsRequest, dict)]=None, *, parent: str=None, filter: str=None, retry: retries.Retry=gapic_v1.method.DEFAULT, timeout: float=None, metadata: Sequence[Tuple[(str, str)]]=()) -> pagers.ListUserEventsPager:
    'Gets a list of user events within a time range, with\n        potential filtering.\n\n        Args:\n            request (Union[google.cloud.recommendationengine_v1beta1.types.ListUserEventsRequest, dict]):\n                The request object. Request message for ListUserEvents\n                method.\n            parent (str):\n                Required. The parent eventStore resource name, such as\n                ``projects/*/locations/*/catalogs/default_catalog/eventStores/default_event_store``.\n\n                This corresponds to the ``parent`` field\n                on the ``request`` instance; if ``request`` is provided, this\n                should not be set.\n            filter (str):\n                Optional. Filtering expression to specify restrictions\n                over returned events. This is a sequence of terms, where\n                each term applies some kind of a restriction to the\n                returned user events. Use this expression to restrict\n                results to a specific time range, or filter events by\n                eventType. eg: eventTime > "2012-04-23T18:25:43.511Z"\n                eventsMissingCatalogItems\n                eventTime<"2012-04-23T18:25:43.511Z" eventType=search\n\n                We expect only 3 types of fields:\n\n                ::\n\n                   * eventTime: this can be specified a maximum of 2 times, once with a\n                     less than operator and once with a greater than operator. The\n                     eventTime restrict should result in one contiguous valid eventTime\n                     range.\n\n                   * eventType: only 1 eventType restriction can be specified.\n\n                   * eventsMissingCatalogItems: specififying this will restrict results\n                     to events for which catalog items were not found in the catalog. The\n                     default behavior is to return only those events for which catalog\n                     items were found.\n\n                Some examples of valid filters expressions:\n\n                -  Example 1: eventTime > "2012-04-23T18:25:43.511Z"\n                   eventTime < "2012-04-23T18:30:43.511Z"\n                -  Example 2: eventTime > "2012-04-23T18:25:43.511Z"\n                   eventType = detail-page-view\n                -  Example 3: eventsMissingCatalogItems eventType =\n                   search eventTime < "2018-04-23T18:30:43.511Z"\n                -  Example 4: eventTime > "2012-04-23T18:25:43.511Z"\n                -  Example 5: eventType = search\n                -  Example 6: eventsMissingCatalogItems\n\n                This corresponds to the ``filter`` field\n                on the ``request`` instance; if ``request`` is provided, this\n                should not be set.\n            retry (google.api_core.retry.Retry): Designation of what errors, if any,\n                should be retried.\n            timeout (float): The timeout for this request.\n            metadata (Sequence[Tuple[str, str]]): Strings which should be\n                sent along with the request as metadata.\n\n        Returns:\n            google.cloud.recommendationengine_v1beta1.services.user_event_service.pagers.ListUserEventsPager:\n                Response message for ListUserEvents\n                method.\n                Iterating over this object will yield\n                results and resolve additional pages\n                automatically.\n\n        '
    has_flattened_params = any([parent, filter])
    if ((request is not None) and has_flattened_params):
        raise ValueError('If the `request` argument is set, then none of the individual field arguments should be set.')
    if (not isinstance(request, user_event_service.ListUserEventsRequest)):
        request = user_event_service.ListUserEventsRequest(request)
        if (parent is not None):
            request.parent = parent
        if (filter is not None):
            request.filter = filter
    rpc = self._transport._wrapped_methods[self._transport.list_user_events]
    metadata = (tuple(metadata) + (gapic_v1.routing_header.to_grpc_metadata((('parent', request.parent),)),))
    response = rpc(request, retry=retry, timeout=timeout, metadata=metadata)
    response = pagers.ListUserEventsPager(method=rpc, request=request, response=response, metadata=metadata)
    return response
Gets a list of user events within a time range, with
potential filtering.

Args:
    request (Union[google.cloud.recommendationengine_v1beta1.types.ListUserEventsRequest, dict]):
        The request object. Request message for ListUserEvents
        method.
    parent (str):
        Required. The parent eventStore resource name, such as
        ``projects/*/locations/*/catalogs/default_catalog/eventStores/default_event_store``.

        This corresponds to the ``parent`` field
        on the ``request`` instance; if ``request`` is provided, this
        should not be set.
    filter (str):
        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

        This corresponds to the ``filter`` field
        on the ``request`` instance; if ``request`` is provided, this
        should not be set.
    retry (google.api_core.retry.Retry): Designation of what errors, if any,
        should be retried.
    timeout (float): The timeout for this request.
    metadata (Sequence[Tuple[str, str]]): Strings which should be
        sent along with the request as metadata.

Returns:
    google.cloud.recommendationengine_v1beta1.services.user_event_service.pagers.ListUserEventsPager:
        Response message for ListUserEvents
        method.
        Iterating over this object will yield
        results and resolve additional pages
        automatically.
def list_user_events(self, request: Union[(user_event_service.ListUserEventsRequest, dict)]=None, *, parent: str=None, filter: str=None, retry: retries.Retry=gapic_v1.method.DEFAULT, timeout: float=None, metadata: Sequence[Tuple[(str, str)]]=()) -> pagers.ListUserEventsPager:
    'Gets a list of user events within a time range, with\n        potential filtering.\n\n        Args:\n            request (Union[google.cloud.recommendationengine_v1beta1.types.ListUserEventsRequest, dict]):\n                The request object. Request message for ListUserEvents\n                method.\n            parent (str):\n                Required. The parent eventStore resource name, such as\n                ``projects/*/locations/*/catalogs/default_catalog/eventStores/default_event_store``.\n\n                This corresponds to the ``parent`` field\n                on the ``request`` instance; if ``request`` is provided, this\n                should not be set.\n            filter (str):\n                Optional. Filtering expression to specify restrictions\n                over returned events. This is a sequence of terms, where\n                each term applies some kind of a restriction to the\n                returned user events. Use this expression to restrict\n                results to a specific time range, or filter events by\n                eventType. eg: eventTime > "2012-04-23T18:25:43.511Z"\n                eventsMissingCatalogItems\n                eventTime<"2012-04-23T18:25:43.511Z" eventType=search\n\n                We expect only 3 types of fields:\n\n                ::\n\n                   * eventTime: this can be specified a maximum of 2 times, once with a\n                     less than operator and once with a greater than operator. The\n                     eventTime restrict should result in one contiguous valid eventTime\n                     range.\n\n                   * eventType: only 1 eventType restriction can be specified.\n\n                   * eventsMissingCatalogItems: specififying this will restrict results\n                     to events for which catalog items were not found in the catalog. The\n                     default behavior is to return only those events for which catalog\n                     items were found.\n\n                Some examples of valid filters expressions:\n\n                -  Example 1: eventTime > "2012-04-23T18:25:43.511Z"\n                   eventTime < "2012-04-23T18:30:43.511Z"\n                -  Example 2: eventTime > "2012-04-23T18:25:43.511Z"\n                   eventType = detail-page-view\n                -  Example 3: eventsMissingCatalogItems eventType =\n                   search eventTime < "2018-04-23T18:30:43.511Z"\n                -  Example 4: eventTime > "2012-04-23T18:25:43.511Z"\n                -  Example 5: eventType = search\n                -  Example 6: eventsMissingCatalogItems\n\n                This corresponds to the ``filter`` field\n                on the ``request`` instance; if ``request`` is provided, this\n                should not be set.\n            retry (google.api_core.retry.Retry): Designation of what errors, if any,\n                should be retried.\n            timeout (float): The timeout for this request.\n            metadata (Sequence[Tuple[str, str]]): Strings which should be\n                sent along with the request as metadata.\n\n        Returns:\n            google.cloud.recommendationengine_v1beta1.services.user_event_service.pagers.ListUserEventsPager:\n                Response message for ListUserEvents\n                method.\n                Iterating over this object will yield\n                results and resolve additional pages\n                automatically.\n\n        '
    has_flattened_params = any([parent, filter])
    if ((request is not None) and has_flattened_params):
        raise ValueError('If the `request` argument is set, then none of the individual field arguments should be set.')
    if (not isinstance(request, user_event_service.ListUserEventsRequest)):
        request = user_event_service.ListUserEventsRequest(request)
        if (parent is not None):
            request.parent = parent
        if (filter is not None):
            request.filter = filter
    rpc = self._transport._wrapped_methods[self._transport.list_user_events]
    metadata = (tuple(metadata) + (gapic_v1.routing_header.to_grpc_metadata((('parent', request.parent),)),))
    response = rpc(request, retry=retry, timeout=timeout, metadata=metadata)
    response = pagers.ListUserEventsPager(method=rpc, request=request, response=response, metadata=metadata)
    return response