ชุดข้อมูลแสดงคอนเทนเนอร์การฉายภาพสำหรับจุดข้อมูล โดยจะไม่มีข้อมูลใดๆ ของตนเอง ชุดข้อมูลแสดงถึงชุดของจุดข้อมูลจากแหล่งข้อมูลหนึ่งๆ พบจุดข้อมูลได้ในชุดข้อมูลมากกว่า 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 }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
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 ชุด
วิธีนี้ไม่ได้ใช้ความหมายของแพตช์: จุดข้อมูลที่ระบุเป็นเพียงการแทรกเท่านั้น โดยไม่ได้แทนที่ข้อมูลที่มีอยู่