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 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון 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."]]
