ชุดข้อมูลหมายถึงคอนเทนเนอร์การคาดคะเนสําหรับจุดข้อมูล และไม่มีข้อมูลใดๆ ของตนเอง ชุดข้อมูลแสดงชุดข้อมูลจากแหล่งข้อมูลหนึ่งๆ จุดข้อมูลอยู่ในชุดข้อมูลมากกว่า 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 |
เวลาสิ้นสุดของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น | |
point[].modifiedTimeMillis |
long |
ระบุเวลาที่แก้ไขจุดข้อมูลครั้งล่าสุด มีประโยชน์ในบริบทที่เราแสดงข้อมูลการเปลี่ยนแปลงข้อมูลเท่านั้น ไม่ได้แสดงถึงสถานะปัจจุบันของข้อมูล | |
point[].originDataSourceId |
string |
หากจุดข้อมูลอยู่ในชุดข้อมูลสําหรับแหล่งข้อมูลที่ได้รับข้อมูล ช่องนี้จะสร้างขึ้นด้วยรหัสสตรีมของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก คําเตือน: อย่าพึ่งพาช่องนี้เพื่อจุดประสงค์อื่นนอกเหนือจากการแก้ไขข้อบกพร่อง ค่าของช่องนี้หากกําหนดไว้จะเป็นรายละเอียดการติดตั้งใช้งานและไม่รับประกันว่าจะสอดคล้องกัน |
|
point[].rawTimestampNanos |
long |
การประทับเวลาดิบจาก SensorEvent เดิม | |
point[].startTimeNanos |
long |
เวลาเริ่มต้นของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น | |
point[].value[] |
list |
ค่าของช่องประเภทข้อมูลแต่ละประเภทสําหรับจุดข้อมูล เป็นเรื่องปกติที่แต่ละค่าที่เกี่ยวข้องกับช่องประเภทข้อมูลจะเกิดขึ้นตามลําดับเดียวกันกับที่แสดงในช่องประเภทข้อมูลในแหล่งข้อมูล ระบบจะเติมข้อมูลในช่องจํานวนเต็มและทศนิยมเพียง 1 ช่อง ขึ้นอยู่กับค่าการแจกแจงรูปแบบภายในช่องประเภทข้อมูล |
|
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 ชุด
วิธีนี้ไม่ได้ใช้ความหมายของแพตช์: ระบบจะแทรกจุดข้อมูลที่ให้ไว้เท่านั้น โดยไม่แทนที่ข้อมูลที่มีอยู่