Users.dataSources.datasets: delete
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
تمام نقاط داده‌ای را که زمان شروع و پایان آن‌ها با محدوده زمانی مشخص‌شده توسط شناسه مجموعه داده‌ها همپوشانی دارند، به‌طور جامع حذف می‌کند. برای اکثر انواع داده، کل نقطه داده حذف خواهد شد. برای انواع داده که بازه زمانی یک مقدار ثابت را نشان می‌دهد (مانند com.google.activity.segment )، و یک نقطه داده در هر یک از نقاط پایانی مجموعه داده قرار دارد، فقط قسمت همپوشانی نقطه داده حذف خواهد شد. اکنون آن را امتحان کنید .
درخواست کنید
درخواست HTTP
DELETE https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
پارامترها
| نام پارامتر | ارزش | توضیحات |
|---|
| پارامترهای مسیر |
dataSourceId | string | شناسه جریان داده منبع داده ای که مجموعه داده را ایجاد کرده است. |
datasetId | string | شناسه مجموعه داده که ترکیبی از حداقل زمان شروع نقطه داده و حداکثر زمان پایان نقطه داده است که به صورت نانوثانیه از دوره نمایش داده می شود. شناسه به این صورت است: " startTime - endTime " که در آن startTime و endTime اعداد صحیح 64 بیتی هستند. |
userId | string | یک مجموعه داده برای شخص شناسایی شده را حذف کنید. از me برای نشان دادن کاربر تایید شده استفاده کنید. در حال حاضر فقط me پشتیبانی می شود. |
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:
| دامنه |
|---|
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 |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
پاسخ
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ خالی را برمی گرداند.
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
