Method: projects.locations.catalogs.eventStores.userEvents.list

Gets a list of user events within a time range, with potential filtering.

HTTP request

GET https://recommendationengine.googleapis.com/v1beta1/{parent=projects/*/locations/*/catalogs/*/eventStores/*}/userEvents

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The parent eventStore resource name, such as "projects/*/locations/*/catalogs/default_catalog/eventStores/default_event_store".

Authorization requires the following IAM permission on the specified resource parent:

  • automlrecommendations.events.list

Query parameters

Parameters
pageSize

integer

Optional. Maximum number of results to return per page. If zero, the service will choose a reasonable default.

pageToken

string

Optional. The previous ListUserEventsResponse.next_page_token.

filter

string

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

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for userEvents.list method.

JSON representation
{
  "userEvents": [
    {
      object (UserEvent)
    }
  ],
  "nextPageToken": string
}
Fields
userEvents[]

object (UserEvent)

The user events.

nextPageToken

string

If empty, the list is complete. If nonempty, the token to pass to the next request's userEvents.list.page_token.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.