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 |
ตัวระบุชุดข้อมูลที่เป็นองค์ประกอบของเวลาเริ่มต้นของจุดข้อมูลต่ำสุด
และเวลาสิ้นสุดของจุดข้อมูลสูงสุดแสดงเป็นนาโนวินาทีจาก Epoch
รหัสมีรูปแบบดังนี้ "startTime-endTime"
โดยที่ startTime และ endTime เป็นจำนวนเต็ม 64 บิต
|
userId |
string |
ลบชุดข้อมูลของบุคคลที่ระบุ ใช้ me เพื่อระบุ
ผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว รองรับ me เท่านั้นในขณะนี้
|
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต
ขอบเขต |
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 |
สำหรับข้อมูลเพิ่มเติม โปรดดูที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์
เนื้อหาของคำขอ
โปรดอย่าให้เนื้อหาคำขอตามวิธีการนี้
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับที่ว่างเปล่า
ลองใช้งาน
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบสดและดูการตอบกลับ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 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."]]