Users.dataSources.datasets

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

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