# Fitness . 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)`

    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)
      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.
      limit: integer, If specified, no more than this many data point changes will be included in the response.

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

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