Fitness API . users . dataSources . dataPointChanges

Instance Methods

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

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.