Method: projects.datasets.ingestDataItems

Ingest data items into a dataset.

HTTP request

POST https://infer.googleapis.com/v1/{name=projects/*/datasets/*}:ingestDataItems

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The dataset which will ingest the data items. Should be the dataset name returned by the create request.

Request body

The request body contains data with the following structure:

JSON representation
{
  "dataItems": [
    {
      object(DataItem)
    }
  ]
}
Fields
dataItems[]

object(DataItem)

DataItems that contain updates.

Response body

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

Response for an datasets.ingestDataItems RPC.

JSON representation
{
  "status": {
    object(Status)
  }
}
Fields
status

object(Status)

Status of the ingestion operation.

Authorization Scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.

DataItem

Represents an entry in a data source.

Each item has a 'dataName', which represents the type of the data (e.g. 'pressure').

Each item has a 'dataValue'. For example, if the data source 'dataName' is 'pressure', this would be a value (e.g. '110psi').

All items sharing the same DataItem.group_id are represented as a composite group in the system.

Composite groups are the basic unit of aggregation during score computation: items in the same composite group can be scored together.

Both data names and values must be composed of alphanumeric characters only. The underscore '_' is also allowed.

Each item must have a 'start_timestamp' and it should be strictly positive ('start_timestamp.seconds' > 0). 'start_timestamp' represents the timestamp at which the action started (e.g. start_timestamp.seconds = 1481568467).

If the item represents an attribute which is true over a certain period of time, an 'end_timestamp' can also be specified (e.g. end_timestamp.seconds = 1481568468).

For example, if a DataItem has start_timestamp.seconds = 1481568467 and end_timestamp.seconds = 1481568468 means its value holds for the entire 1 second time interval.

JSON representation
{
  "dataName": string,
  "dataValue": string,
  "groupId": string,
  "startTime": string,
  "endTime": string
}
Fields
dataName

string

Data name (e.g. 'pressure').

dataValue

string

Data value. (e.g. '110psi')

groupId

string (int64 format)

Composite group ID.

startTime

string (Timestamp format)

Required. Data start timestamp (e.g. t0).

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Optional. Data end timestamp (e.g. t1).

A timestamp in RFC3339 UTC "Zulu" format, accurate to nanoseconds. Example: "2014-10-02T15:01:23.045123456Z".