# Fitness API . users . dataSources . dataPointChanges

## Instance Methods

Queries for user's data point changes for a particular data source.

Retrieves the next page of results.

### Method Details

`list(userId, dataSourceId, pageToken=None, limit=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)
      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.
      limit: integer, If specified, no more than this many data point changes will be included
    in the response.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        {
        "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.
            "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.
            "startTimeNanos": "A String", # The start time of the interval represented by this data point, in
                # nanoseconds since epoch.
            "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.
            "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.
            "rawTimestampNanos": "A String", # The raw timestamp from the original SensorEvent.
            "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.
                "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.
                "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",
                  },
                ],
                "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.
              },
            ],
          },
        ],
        "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.
            "startTimeNanos": "A String", # The start time of the interval represented by this data point, in
                # nanoseconds since epoch.
            "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.
            "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.
            "rawTimestampNanos": "A String", # The raw timestamp from the original SensorEvent.
            "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.
                "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.
                "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",
                  },
                ],
                "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.
              },
            ],
          },
        ],
        "dataSourceId": "A String", # The data stream ID of the data source with data point changes.
      }

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