Users.dataSources.datasets: patch

เพิ่มจุดข้อมูลลงในชุดข้อมูล โดยที่ไม่ต้องสร้างชุดข้อมูลไว้ก่อนหน้านี้ จุดทั้งหมดภายในชุดข้อมูลที่ระบุจะส่งคืนพร้อมการเรียกใช้ช่วงต่อเพื่อเรียกข้อมูลชุดข้อมูลนี้ จุดข้อมูลสามารถอยู่ในชุดข้อมูลมากกว่า 1 ชุด

วิธีนี้ไม่ได้ใช้ความหมายของแพตช์: จุดข้อมูลที่ระบุเป็นเพียงการแทรกเท่านั้น โดยไม่ได้แทนที่ข้อมูลที่มีอยู่ ลองเลย

ส่งคำขอ

คำขอ HTTP

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

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์เส้นทาง
dataSourceId string รหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างชุดข้อมูล
datasetId string ไม่ได้ใช้ฟิลด์นี้ และละเว้นได้อย่างปลอดภัย
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

ดูข้อมูลเพิ่มเติมได้ที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์

เนื้อหาของคำขอ

ในเนื้อหาคำขอ ให้ระบุส่วนที่เกี่ยวข้องของทรัพยากร Users.dataSources.datasets ตามกฎความหมายของแพตช์พร้อมพร็อพเพอร์ตี้ต่อไปนี้

ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
พร็อพเพอร์ตี้ที่จำเป็น
dataSourceId string รหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างจุดในชุดข้อมูลนี้
maxEndTimeNs long เวลาสิ้นสุดที่มากที่สุดของจุดข้อมูลทั้งหมดในรายการนี้ซึ่งอาจเป็นตัวแทนบางส่วนของชุดข้อมูล เวลาเป็นหน่วยนาโนวินาทีจาก Epoch ซึ่งควรตรงกับส่วนที่ 2 ของตัวระบุชุดข้อมูล
minStartTimeNs long เวลาเริ่มต้นที่น้อยที่สุดของจุดข้อมูลทั้งหมดในรายการนี้ซึ่งอาจเป็นตัวแทนบางส่วนของชุดข้อมูล เวลาเป็นหน่วยนาโนวินาทีจาก Epoch ซึ่งควรตรงกับส่วนแรกของตัวระบุชุดข้อมูล
point[] list รายการบางส่วนของจุดข้อมูลที่มีอยู่ในชุดข้อมูล โดยเรียงลำดับตาม endTimeNanos รายการนี้จะถือว่าสมบูรณ์เมื่อเรียกข้อมูลชุดข้อมูลขนาดเล็กและบางส่วนเมื่อแพตช์ชุดข้อมูลหรือดึงชุดข้อมูลที่มีขนาดใหญ่เกินไปที่จะรวมไว้ในการตอบกลับรายการเดียว
point[].dataTypeName string ประเภทข้อมูลที่กําหนดรูปแบบของค่าในจุดข้อมูลนี้
point[].endTimeNanos long เวลาสิ้นสุดของช่วงที่แสดงโดยจุดข้อมูลนี้ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch
point[].startTimeNanos long เวลาเริ่มต้นของช่วงที่แสดงโดยจุดข้อมูลนี้ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch
point[].value[] list ค่าของช่องประเภทข้อมูลแต่ละช่องสําหรับจุดข้อมูล คาดว่าแต่ละค่าที่เกี่ยวข้องกับช่องประเภทข้อมูลจะปรากฏในลำดับเดียวกับที่มีการแสดงช่องดังกล่าวในประเภทข้อมูลที่ระบุในแหล่งข้อมูล

ระบบจะเติมข้อมูลในช่องจำนวนเต็มและจุดทศนิยมเพียง 1 ช่องเท่านั้น ทั้งนี้ขึ้นอยู่กับค่า enum ของรูปแบบภายในช่องประเภทแหล่งข้อมูล

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงผล Users.dataSources.datasets resource ในเนื้อหาการตอบสนอง

ลองใช้เลย

ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้ในข้อมูลสดและดูการตอบสนอง