ชุดข้อมูลแสดงถึงคอนเทนเนอร์การฉายภาพสำหรับจุดข้อมูล โดยจะไม่ได้เก็บข้อมูลใดๆ ของตนเองไว้ ชุดข้อมูลแสดงชุดของจุดข้อมูลจากแหล่งข้อมูลหนึ่งๆ จุดข้อมูลจะอยู่ในชุดข้อมูลมากกว่า 1 ชุด
ดูรายการเมธอดสำหรับทรัพยากรนี้ได้ที่ส่วนท้ายของหน้านี้
การนำเสนอแหล่งข้อมูล
{ "minStartTimeNs": long, "maxEndTimeNs": long, "dataSourceId": string, "point": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
dataSourceId |
string |
รหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างจุดในชุดข้อมูลนี้ | |
maxEndTimeNs |
long |
เวลาสิ้นสุดที่ใหญ่ที่สุดของจุดข้อมูลทั้งหมดในชุดข้อมูลนี้ซึ่งอาจนำเสนอเพียงบางส่วน เวลานับจาก Epoch ในหน่วยนาโนวินาที ซึ่งควรตรงกับส่วนที่ 2 ของตัวระบุชุดข้อมูลด้วย | |
minStartTimeNs |
long |
เวลาเริ่มต้นที่น้อยที่สุดของจุดข้อมูลทั้งหมดในชุดข้อมูลนี้ซึ่งอาจนำเสนอเพียงบางส่วน เวลานับจาก Epoch ในหน่วยนาโนวินาที ซึ่งควรตรงกับส่วนแรกของตัวระบุชุดข้อมูลด้วย | |
nextPageToken |
string |
ระบบจะตั้งค่าโทเค็นนี้เมื่อได้รับชุดข้อมูลเพื่อตอบกลับคำขอ GET และชุดข้อมูลมีขนาดใหญ่เกินไปที่จะรวมไว้ในการตอบกลับเดียว ระบุค่านี้ในคำขอ GET ครั้งต่อๆ ไปเพื่อให้แสดงจุดข้อมูลหน้าถัดไปภายในชุดข้อมูลนี้ | |
point[] |
list |
รายการจุดข้อมูลบางส่วนที่อยู่ในชุดข้อมูล เรียงลำดับตาม endTimeNanos รายการนี้จะถือว่าเสร็จสมบูรณ์เมื่อดึงชุดข้อมูลขนาดเล็กและบางส่วนเมื่อแพตช์ชุดข้อมูลหรือดึงข้อมูลชุดข้อมูลที่มีขนาดใหญ่เกินไปที่จะรวมไว้ในการตอบกลับเดียว | |
point[].computationTimeMillis |
long |
ห้ามใช้ช่องนี้ โดยระบบจะไม่สนใจและไม่เก็บข้อมูลไว้ | |
point[].dataTypeName |
string |
ประเภทข้อมูลที่กำหนดรูปแบบของค่าในจุดข้อมูลนี้ | |
point[].endTimeNanos |
long |
เวลาสิ้นสุดของช่วงเวลาที่จุดข้อมูลนี้แสดง ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch | |
point[].modifiedTimeMillis |
long |
ระบุเวลาล่าสุดที่มีการแก้ไขจุดข้อมูลนี้ มีประโยชน์เฉพาะในบริบทที่เราแสดงการเปลี่ยนแปลงข้อมูลเท่านั้น แทนที่จะแสดงสถานะปัจจุบันของข้อมูล | |
point[].originDataSourceId |
string |
หากมีจุดข้อมูลอยู่ในชุดข้อมูลของแหล่งข้อมูลที่ได้มา ระบบจะเติมข้อมูลในช่องนี้ด้วยรหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก คำเตือน: โปรดอย่าอาศัยข้อมูลในช่องนี้นอกเหนือจากการแก้ไขข้อบกพร่อง ค่าของช่องนี้หากมีการตั้งค่าไว้เลยจะเป็นรายละเอียดการใช้งานและไม่รับประกันว่าจะคงความสอดคล้องกันไว้ |
|
point[].rawTimestampNanos |
long |
การประทับเวลาดิบจาก SensorEvent ดั้งเดิม | |
point[].startTimeNanos |
long |
เวลาเริ่มต้นของช่วงเวลาที่จุดข้อมูลนี้แสดง ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch | |
point[].value[] |
list |
ค่าของช่องประเภทข้อมูลแต่ละประเภทสำหรับจุดข้อมูล คาดว่าแต่ละค่าที่เกี่ยวข้องกับช่องประเภทข้อมูลจะเกิดขึ้นในลำดับเดียวกันกับที่ช่องแสดงในประเภทข้อมูลที่ระบุไว้ในแหล่งข้อมูล ระบบจะป้อนข้อมูลในช่องจำนวนเต็มและจุดทศนิยมเพียง 1 ช่องเท่านั้น โดยขึ้นอยู่กับค่า Enum ของรูปแบบภายในช่องประเภทของแหล่งข้อมูล |
|
point[].value[].fpVal |
double |
ค่าจุดทศนิยม เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้ | |
point[].value[].intVal |
integer |
ค่าจำนวนเต็ม เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้ | |
point[].value[].mapVal[] |
list |
แมปค่า ควรมีการบันทึกพื้นที่คีย์และหน่วยที่ถูกต้องสำหรับค่าที่เกี่ยวข้องของแต่ละรายการไว้ในการกำหนดประเภทข้อมูล คีย์ควรมีขนาดเล็กเมื่อเป็นไปได้ ระบบอาจลดการสุ่มตัวอย่างสตรีมข้อมูลที่มีคีย์ขนาดใหญ่และความถี่ของข้อมูลสูง | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
ค่าจุดทศนิยม | |
point[].value[].stringVal |
string |
ค่าสตริง เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้ สตริงควรมีขนาดเล็กเมื่อเป็นไปได้ ระบบอาจสุ่มตัวอย่างสตรีมข้อมูลที่มีค่าสตริงมากและความถี่ของข้อมูลสูง |
เมธอด
- ลบ
- ดำเนินการลบจุดข้อมูลทั้งหมดที่มีเวลาเริ่มต้นและเวลาสิ้นสุด โดยนับรวมทุกจุด
มีช่วงเวลาทับซ้อนกับช่วงเวลาที่ระบุโดยรหัสชุดข้อมูล สำหรับ
ประเภทข้อมูล จุดข้อมูลทั้งหมดจะถูกลบ สำหรับประเภทข้อมูลที่
ช่วงเวลาแสดงถึงค่าที่สอดคล้องกัน (เช่น
com.google.activity.segment
) และคร่อมจุดข้อมูล จุดสิ้นสุดของชุดข้อมูลฝ่ายใดฝ่ายหนึ่ง ซึ่งพบได้เฉพาะส่วนที่ซ้อนทับกันของข้อมูล จุดจะถูกลบ - รับ
- แสดงผลชุดข้อมูลที่มีจุดข้อมูลทั้งหมดซึ่งมีเวลาเริ่มต้นและเวลาสิ้นสุด ทับซ้อนกับช่วงของเวลาเริ่มต้นขั้นต่ำของชุดข้อมูลที่ระบุ เวลาสิ้นสุดสูงสุด โดยเฉพาะอย่างยิ่ง จุดข้อมูลที่มีเวลาเริ่มต้นน้อยกว่า มากกว่าหรือเท่ากับเวลาสิ้นสุดของชุดข้อมูล และเวลาสิ้นสุดมากกว่าหรือ เท่ากับเวลาเริ่มต้นของชุดข้อมูล
- แพตช์
- เพิ่มจุดข้อมูลลงในชุดข้อมูล ไม่จำเป็นต้องสร้างชุดข้อมูลก่อนหน้านี้
จุดทั้งหมดภายในชุดข้อมูลที่ระบุจะได้รับการส่งคืนพร้อมกับการเรียกใช้ครั้งต่อๆ ไป
เพื่อดึงข้อมูลชุดข้อมูลนี้ จุดข้อมูลสามารถอยู่ในชุดข้อมูลได้มากกว่า 1 รายการ
วิธีนี้ไม่ได้ใช้ความหมายของแพตช์: จุดข้อมูลที่ระบุคือ แทรกไว้เท่านั้น โดยไม่มีข้อมูลใดมาแทนที่