list(userId, dataSourceId, limit=None, pageToken=None, x__xgafv=None)
Queries for user's data point changes for a particular data source.
list_next(previous_request, previous_response)
Retrieves the next page of results.
list(userId, dataSourceId, limit=None, pageToken=None, x__xgafv=None)
Queries for user's data point changes for a particular data source.
Args:
userId: string, List data points for the person identified. Use <code>me</code> to indicate
the authenticated user. Only <code>me</code> is supported at this time. (required)
dataSourceId: string, The data stream ID of the data source that created the dataset. (required)
limit: integer, If specified, no more than this many data point changes will be included
in the response.
pageToken: string, The continuation token, which is used to page through large result sets.
To get the next page of results, set this parameter to the value of
<code>nextPageToken</code> from the previous response.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{
"dataSourceId": "A String", # The data stream ID of the data source with data point changes.
"nextPageToken": "A String", # The continuation token, which is used to page through large result sets.
# Provide this value in a subsequent request to return the next page of
# results.
"insertedDataPoint": [ # Inserted data points for the user.
{ # Represents a single data point, generated by a particular data source. A
# data point holds a value for each field, an end timestamp and an optional
# start time. The exact semantics of each of these attributes are specified in
# the documentation for the particular data type.
#
# A data point can represent an instantaneous measurement, reading or input
# observation, as well as averages or aggregates over a time interval. Check
# the data type documentation to determine which is the case for a particular
# data type.
#
# Data points always contain one value for each field of the data type.
"modifiedTimeMillis": "A String", # Indicates the last time this data point was modified. Useful only in
# contexts where we are listing the data changes, rather than representing
# the current state of the data.
"originDataSourceId": "A String", # If the data point is contained in a dataset for a derived data source,
# this field will be populated with the data source stream ID that created
# the data point originally.
#
# WARNING: do not rely on this field for anything other than debugging. The
# value of this field, if it is set at all, is an implementation detail and
# is not guaranteed to remain consistent.
"rawTimestampNanos": "A String", # The raw timestamp from the original SensorEvent.
"dataTypeName": "A String", # The data type defining the format of the values in this data point.
"startTimeNanos": "A String", # The start time of the interval represented by this data point, in
# nanoseconds since epoch.
"value": [ # Values of each data type field for the data point. It is expected that each
# value corresponding to a data type field will occur in the same order that
# the field is listed with in the data type specified in a data source.
#
# Only one of integer and floating point fields will be populated, depending
# on the format enum value within data source's type field.
{ # Holder object for the value of a single field in a data point.
#
# A field value has a particular format and is only ever set to one of an
# integer or a floating point value.
"fpVal": 3.14, # Floating point value. When this is set, other values must not be set.
"mapVal": [ # Map value. The valid key space and units for the corresponding value
# of each entry should be documented as part of the data type definition.
# Keys should be kept small whenever possible. Data streams with large keys
# and high data frequency may be down sampled.
{
"value": { # Holder object for the value of an entry in a map field of a data point.
#
# A map value supports a subset of the formats that the regular Value supports.
"fpVal": 3.14, # Floating point value.
},
"key": "A String",
},
],
"intVal": 42, # Integer value. When this is set, other values must not be set.
"stringVal": "A String", # String value. When this is set, other values must not be set.
# Strings should be kept small whenever possible. Data streams with large
# string values and high data frequency may be down sampled.
},
],
"computationTimeMillis": "A String", # DO NOT USE THIS FIELD. It is ignored, and not stored.
"endTimeNanos": "A String", # The end time of the interval represented by this data point, in
# nanoseconds since epoch.
},
],
"deletedDataPoint": [ # Deleted data points for the user. Note, for modifications this should be
# parsed before handling insertions.
{ # Represents a single data point, generated by a particular data source. A
# data point holds a value for each field, an end timestamp and an optional
# start time. The exact semantics of each of these attributes are specified in
# the documentation for the particular data type.
#
# A data point can represent an instantaneous measurement, reading or input
# observation, as well as averages or aggregates over a time interval. Check
# the data type documentation to determine which is the case for a particular
# data type.
#
# Data points always contain one value for each field of the data type.
"modifiedTimeMillis": "A String", # Indicates the last time this data point was modified. Useful only in
# contexts where we are listing the data changes, rather than representing
# the current state of the data.
"originDataSourceId": "A String", # If the data point is contained in a dataset for a derived data source,
# this field will be populated with the data source stream ID that created
# the data point originally.
#
# WARNING: do not rely on this field for anything other than debugging. The
# value of this field, if it is set at all, is an implementation detail and
# is not guaranteed to remain consistent.
"rawTimestampNanos": "A String", # The raw timestamp from the original SensorEvent.
"dataTypeName": "A String", # The data type defining the format of the values in this data point.
"startTimeNanos": "A String", # The start time of the interval represented by this data point, in
# nanoseconds since epoch.
"value": [ # Values of each data type field for the data point. It is expected that each
# value corresponding to a data type field will occur in the same order that
# the field is listed with in the data type specified in a data source.
#
# Only one of integer and floating point fields will be populated, depending
# on the format enum value within data source's type field.
{ # Holder object for the value of a single field in a data point.
#
# A field value has a particular format and is only ever set to one of an
# integer or a floating point value.
"fpVal": 3.14, # Floating point value. When this is set, other values must not be set.
"mapVal": [ # Map value. The valid key space and units for the corresponding value
# of each entry should be documented as part of the data type definition.
# Keys should be kept small whenever possible. Data streams with large keys
# and high data frequency may be down sampled.
{
"value": { # Holder object for the value of an entry in a map field of a data point.
#
# A map value supports a subset of the formats that the regular Value supports.
"fpVal": 3.14, # Floating point value.
},
"key": "A String",
},
],
"intVal": 42, # Integer value. When this is set, other values must not be set.
"stringVal": "A String", # String value. When this is set, other values must not be set.
# Strings should be kept small whenever possible. Data streams with large
# string values and high data frequency may be down sampled.
},
],
"computationTimeMillis": "A String", # DO NOT USE THIS FIELD. It is ignored, and not stored.
"endTimeNanos": "A String", # The end time of the interval represented by this data point, in
# nanoseconds since epoch.
},
],
}
list_next(previous_request, previous_response)
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.