Event

Stay organized with collections Save and categorize content based on your preferences.

Represents an entry in a data source.

Each Event has:

  • A timestamp at which the event occurs.
  • One or multiple dimensions.
  • Optionally, a group ID that allows clients to group logically related events (for example, all events representing payments transactions done by a user in a day have the same group ID). If a group ID is not provided, an internal one will be generated based on the content and eventTime.

NOTE:

  • Internally, we discretize time in equal-sized chunks and we assume an event has a 0 TimeseriesPoint.value in a chunk that does not contain any occurrences of an event in the input.
  • The number of Events with the same group ID should be limited.
  • Group ID cannot be queried.
  • Group ID does not correspond to a user ID or the like. If a user ID is of interest to be queried, use a user ID dimension instead.
JSON representation 
{
  "dimensions": [
    {
      object (EventDimension)
    }
  ],
  "groupId": string,
  "eventTime": string
}
Fields
dimensions[]

object (EventDimension)

Event dimensions.
groupId

string (int64 format)

Event group ID.

NOTE: JSON encoding should use a string to hold a 64-bit integer value, because a native JSON number holds only 53 binary bits for an integer.
eventTime

string (Timestamp format)

Event timestamp.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

EventDimension

Represents an event dimension.

JSON representation 
{
  "name": string,

  // Union field value can be only one of the following:
  "stringVal": string,
  "longVal": string,
  "boolVal": boolean,
  "doubleVal": number
  // End of list of possible types for union field value.
}
Fields
name

string

Dimension name.

NOTE: EventDimension names must be composed of alphanumeric characters only, and are case insensitive. Unicode characters are not supported. The underscore '_' is also allowed.

Union field value. Dimension value.

NOTE: All entries of the dimension name must have the same value type. value can be only one of the following:
stringVal

string

String representation.

NOTE: String values are case insensitive. Unicode characters are supported.
longVal

string (int64 format)

Long representation.
boolVal

boolean

Bool representation.
doubleVal

number

Double representation.