Method: projects.datasets.appendEvents

Append events to a DataSet if it is created with {"streaming": true}.

HTTP request

POST https://{endpoint}/v1/{dataset=projects/*/datasets/*}:appendEvents

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
dataset

string

Required. The DataSet to which we want to append to in the format of "projects/{project}/datasets/{dataset}"

Request body

The request body contains data with the following structure:

JSON representation
{
  "events": [
    {
      object (Event)
    }
  ]
}
Fields
events[]

object (Event)

Events to be appended.

Response body

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

Response for an datasets.appendEvents RPC.

JSON representation
{
  "droppedEvents": [
    {
      object (Event)
    }
  ]
}
Fields
droppedEvents[]

object (Event)

Dropped events; empty if all events are successfully added.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

Event

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 which allows clients to group logically related events (e.g. all events representing payments transactions done by a user in a day have the same group ID).

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 the event in the input.
  • each Event should be in JSON format, with one Event per line.
JSON representation
{
  "dimensions": [
    {
      object (EventDimension)
    }
  ],
  "groupId": string,
  "eventTime": string
}
Fields
dimensions[]

object (EventDimension)

Event dimensions.

groupId

string (int64 format)

Event group ID.

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".