Fitness API . users . dataSources . dataPointChanges

Instance Methods

close()

Close httplib2 connections.

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.

Method Details

close()
Close httplib2 connections.
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 me to indicate the authenticated user. Only me 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 nextPageToken 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.
  "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.
      "computationTimeMillis": "A String", # DO NOT USE THIS FIELD. It is ignored, and not stored.
      "dataTypeName": "A String", # The data type defining the format of the values in this data point.
      "endTimeNanos": "A String", # The end time of the interval represented by this data point, in nanoseconds since epoch.
      "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.
      "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.
          "intVal": 42, # Integer 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.
            {
              "key": "A String",
              "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.
              },
            },
          ],
          "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.
        },
      ],
    },
  ],
  "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.
      "computationTimeMillis": "A String", # DO NOT USE THIS FIELD. It is ignored, and not stored.
      "dataTypeName": "A String", # The data type defining the format of the values in this data point.
      "endTimeNanos": "A String", # The end time of the interval represented by this data point, in nanoseconds since epoch.
      "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.
      "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.
          "intVal": 42, # Integer 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.
            {
              "key": "A String",
              "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.
              },
            },
          ],
          "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.
        },
      ],
    },
  ],
  "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.
}
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.