Users.dataSources.datasets: patch

    • This method adds data points to a dataset, and the dataset does not need to be previously created.

    • All points within the given dataset will be returned with subsequent calls to retrieve this dataset, and data points can belong to more than one dataset.

    • This method inserts data points without replacing existing data.

    • Authorization with specific fitness write scopes is required.

    • The request body requires properties such as dataSourceId , maxEndTimeNs , minStartTimeNs , and a list of point objects with their own properties.

    Adds data points to a dataset. The dataset need not be previously created. All points within the given dataset will be returned with subsquent calls to retrieve this dataset. Data points can belong to more than one dataset.

    This method does not use patch semantics: the data points provided are merely inserted, with no existing data replaced. Try it now .

    Request

    HTTP request

    PATCH https://www.googleapis.com/fitness/v1/users/ userId 
/dataSources/ dataSourceId 
/datasets/ datasetId

    Parameters

    Parameter name
    Value
    Description
    Path parameters
    dataSourceId
    string
    The data stream ID of the data source that created the dataset.
    datasetId
    string
    This field is not used, and can be safely omitted.
    userId
    string
    Patch a dataset for the person identified. Use me to indicate the authenticated user. Only me is supported at this time.

    Authorization

    This request requires authorization with at least one of the following scopes:

    Scope
    https://www.googleapis.com/auth/fitness.activity.write
    https://www.googleapis.com/auth/fitness.location.write
    https://www.googleapis.com/auth/fitness.body.write
    https://www.googleapis.com/auth/fitness.nutrition.write
    https://www.googleapis.com/auth/fitness.blood_pressure.write
    https://www.googleapis.com/auth/fitness.blood_glucose.write
    https://www.googleapis.com/auth/fitness.oxygen_saturation.write
    https://www.googleapis.com/auth/fitness.body_temperature.write
    https://www.googleapis.com/auth/fitness.reproductive_health.write

    For more information, see the authentication and authorization page.

    Request body

    In the request body, supply the relevant portions of a Users.dataSources.datasets resource , according to the rules of patch semantics, with the following properties:

    Property name
    Value
    Description
    Notes
    Required Properties
    dataSourceId
    string
    The data stream ID of the data source that created the points in this dataset.
    maxEndTimeNs
    long
    The largest end time of all data points in this possibly partial representation of the dataset. Time is in nanoseconds from epoch. This should also match the second part of the dataset identifier.
    minStartTimeNs
    long
    The smallest start time of all data points in this possibly partial representation of the dataset. Time is in nanoseconds from epoch. This should also match the first part of the dataset identifier.
    point[]
    list
    A partial list of data points contained in the dataset, ordered by endTimeNanos. This list is considered complete when retrieving a small dataset and partial when patching a dataset or retrieving a dataset that is too large to include in a single response.
    point[]. dataTypeName
    string
    The data type defining the format of the values in this data point.
    point[]. endTimeNanos
    long
    The end time of the interval represented by this data point, in nanoseconds since epoch.
    point[]. startTimeNanos
    long
    The start time of the interval represented by this data point, in nanoseconds since epoch.
    point[]. value[]
    list
    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.

    Response

    If successful, this method returns a Users.dataSources.datasets resource in the response body.

    Try it!

    Use the APIs Explorer below to call this method on live data and see the response.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: