Users.dataSources.datasets: delete
Stay organized with collections
Save and categorize content based on your preferences.
Performs an inclusive delete of all data points whose start and end times
have any overlap with the time range specified by the dataset ID. For most
data types, the entire data point will be deleted. For data types where the
time span represents a consistent value (such as
com.google.activity.segment), and a data point straddles
either end point of the dataset, only the overlapping portion of the data
point will be deleted.
Try it now.
Request
HTTP request
DELETE 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 |
Dataset identifier that is a composite of the minimum data point start time
and maximum data point end time represented as nanoseconds from the epoch.
The ID is formatted like: "startTime-endTime"
where startTime and endTime are 64 bit integers.
|
userId |
string |
Delete 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
Do not supply a request body with this method.
Response
If successful, this method returns an empty response body.
Try it!
Use the APIs Explorer below to call this method on live data and see the response.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2023-11-20 UTC.
[null,null,["Last updated 2023-11-20 UTC."],[[["\u003cp\u003eDeletes all Fitness data points within a specified time range, identified by the \u003ccode\u003edatasetId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFor data types with consistent values, only overlapping portions of data points are deleted.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific scopes like \u003ccode\u003ehttps://www.googleapis.com/auth/fitness.activity.write\u003c/code\u003e or similar for other data types.\u003c/p\u003e\n"],["\u003cp\u003eUses a \u003ccode\u003eDELETE\u003c/code\u003e request to \u003ccode\u003ehttps://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId\u003c/code\u003e with \u003ccode\u003edatasetId\u003c/code\u003e specifying the time range.\u003c/p\u003e\n"],["\u003cp\u003eAn empty response body indicates successful deletion.\u003c/p\u003e\n"]]],[],null,["# Users.dataSources.datasets: delete\n\n| **Note:** Requires [authorization](#auth).\n\nPerforms an inclusive delete of all data points whose start and end times\nhave any overlap with the time range specified by the dataset ID. For most\ndata types, the entire data point will be deleted. For data types where the\ntime span represents a consistent value (such as\n`com.google.activity.segment`), and a data point straddles\neither end point of the dataset, only the overlapping portion of the data\npoint will be deleted.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nDELETE https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|----------------|----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `dataSourceId` | `string` | The data stream ID of the data source that created the dataset. |\n| `datasetId` | `string` | Dataset identifier that is a composite of the minimum data point start time and maximum data point end time represented as nanoseconds from the epoch. The ID is formatted like: \"\u003cvar translate=\"no\"\u003estartTime\u003c/var\u003e-\u003cvar translate=\"no\"\u003eendTime\u003c/var\u003e\" where \u003cvar translate=\"no\"\u003estartTime\u003c/var\u003e and \u003cvar translate=\"no\"\u003eendTime\u003c/var\u003e are 64 bit integers. |\n| `userId` | `string` | Delete a dataset for the person identified. Use `me` to indicate the authenticated user. Only `me` is supported at this time. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|---------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/fitness.activity.write` |\n| `https://www.googleapis.com/auth/fitness.location.write` |\n| `https://www.googleapis.com/auth/fitness.body.write` |\n| `https://www.googleapis.com/auth/fitness.nutrition.write` |\n| `https://www.googleapis.com/auth/fitness.blood_pressure.write` |\n| `https://www.googleapis.com/auth/fitness.blood_glucose.write` |\n| `https://www.googleapis.com/auth/fitness.oxygen_saturation.write` |\n| `https://www.googleapis.com/auth/fitness.body_temperature.write` |\n| `https://www.googleapis.com/auth/fitness.reproductive_health.write` |\n\nFor more information, see the [authentication and authorization](/fit/rest/v1/authorization) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns an empty response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
