Users.dataSources.dataPointChanges: list

คำค้นหาสำหรับจุดข้อมูลของผู้ใช้มีการเปลี่ยนแปลงสำหรับแหล่งข้อมูลหนึ่งๆ ลองใช้เลย

ส่งคำขอ

คำขอ HTTP

GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์เส้นทาง
dataSourceId string รหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างชุดข้อมูล
userId string แสดงรายการจุดข้อมูลของบุคคลที่ระบุ ใช้ me เพื่อระบุ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว รองรับ me เท่านั้นในขณะนี้
พารามิเตอร์การค้นหาที่ไม่บังคับ
limit integer หากระบุ ระบบจะรวมการเปลี่ยนแปลงจุดข้อมูลไม่เกินจำนวนนี้ ในการตอบกลับ
pageToken string โทเค็นต่อเนื่อง ซึ่งใช้เพื่อเลื่อนดูชุดผลลัพธ์ขนาดใหญ่ หากต้องการดูผลการค้นหาหน้าถัดไป ให้ตั้งค่าพารามิเตอร์นี้เป็นค่า nextPageToken จากคำตอบก่อนหน้า

การให้สิทธิ์

คำขอนี้ต้องได้รับการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต

ขอบเขต
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

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

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

โปรดอย่าให้เนื้อหาคำขอตามวิธีการนี้

คำตอบ

หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับพร้อมโครงสร้างต่อไปนี้

{
  "insertedDataPoint": [
    {
      "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
    }
  ],
  "deletedDataPoint": [
    {
      "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
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย หมายเหตุ
insertedDataPoint[] list แทรกจุดข้อมูลสำหรับผู้ใช้แล้ว
insertedDataPoint[].startTimeNanos long เวลาเริ่มต้นของช่วงเวลาที่จุดข้อมูลนี้แสดง ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch
insertedDataPoint[].endTimeNanos long เวลาสิ้นสุดของช่วงเวลาที่จุดข้อมูลนี้แสดง ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch
insertedDataPoint[].dataTypeName string ประเภทข้อมูลที่กำหนดรูปแบบของค่าในจุดข้อมูลนี้
insertedDataPoint[].originDataSourceId string หากมีจุดข้อมูลอยู่ในชุดข้อมูลของแหล่งข้อมูลที่ได้มา ระบบจะเติมข้อมูลในช่องนี้ด้วยรหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก

คำเตือน: โปรดอย่าอาศัยข้อมูลในช่องนี้นอกเหนือจากการแก้ไขข้อบกพร่อง ค่าของช่องนี้หากมีการตั้งค่าไว้เลยจะเป็นรายละเอียดการใช้งานและไม่รับประกันว่าจะคงความสอดคล้องกันไว้
insertedDataPoint[].value[] list ค่าของช่องประเภทข้อมูลแต่ละประเภทสำหรับจุดข้อมูล คาดว่าแต่ละค่าที่เกี่ยวข้องกับช่องประเภทข้อมูลจะเกิดขึ้นในลำดับเดียวกันกับที่ช่องแสดงในประเภทข้อมูลที่ระบุไว้ในแหล่งข้อมูล

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

insertedDataPoint[].value[].intVal integer ค่าจำนวนเต็ม เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้
insertedDataPoint[].value[].fpVal double ค่าจุดทศนิยม เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้
insertedDataPoint[].value[].stringVal string ค่าสตริง เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้ สตริงควรมีขนาดเล็กเมื่อเป็นไปได้ ระบบอาจสุ่มตัวอย่างสตรีมข้อมูลที่มีค่าสตริงมากและความถี่ของข้อมูลสูง
insertedDataPoint[].value[].mapVal[] list แมปค่า ควรมีการบันทึกพื้นที่คีย์และหน่วยที่ถูกต้องสำหรับค่าที่เกี่ยวข้องของแต่ละรายการไว้ในการกำหนดประเภทข้อมูล คีย์ควรมีขนาดเล็กเมื่อเป็นไปได้ ระบบอาจลดการสุ่มตัวอย่างสตรีมข้อมูลที่มีคีย์ขนาดใหญ่และความถี่ของข้อมูลสูง
insertedDataPoint[].value[].mapVal[].key string
insertedDataPoint[].value[].mapVal[].value nested object
insertedDataPoint[].value[].mapVal[].value.fpVal double ค่าจุดทศนิยม
insertedDataPoint[].modifiedTimeMillis long ระบุเวลาล่าสุดที่มีการแก้ไขจุดข้อมูลนี้ มีประโยชน์เฉพาะในบริบทที่เราแสดงการเปลี่ยนแปลงข้อมูลเท่านั้น แทนที่จะแสดงสถานะปัจจุบันของข้อมูล
insertedDataPoint[].rawTimestampNanos long การประทับเวลาดิบจาก SensorEvent ดั้งเดิม
insertedDataPoint[].computationTimeMillis long ห้ามใช้ช่องนี้ โดยระบบจะไม่สนใจและไม่เก็บข้อมูลไว้
deletedDataPoint[] list ลบจุดข้อมูลสำหรับผู้ใช้แล้ว โปรดทราบว่าสำหรับการแก้ไข คุณควรแยกวิเคราะห์ก่อนที่จะจัดการส่วนแทรก
deletedDataPoint[].startTimeNanos long เวลาเริ่มต้นของช่วงเวลาที่จุดข้อมูลนี้แสดง ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch
deletedDataPoint[].endTimeNanos long เวลาสิ้นสุดของช่วงเวลาที่จุดข้อมูลนี้แสดง ในหน่วยนาโนวินาทีนับตั้งแต่ Epoch
deletedDataPoint[].dataTypeName string ประเภทข้อมูลที่กำหนดรูปแบบของค่าในจุดข้อมูลนี้
deletedDataPoint[].originDataSourceId string หากมีจุดข้อมูลอยู่ในชุดข้อมูลของแหล่งข้อมูลที่ได้มา ระบบจะเติมข้อมูลในช่องนี้ด้วยรหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก

คำเตือน: โปรดอย่าอาศัยข้อมูลในช่องนี้นอกเหนือจากการแก้ไขข้อบกพร่อง ค่าของช่องนี้หากมีการตั้งค่าไว้เลยจะเป็นรายละเอียดการใช้งานและไม่รับประกันว่าจะคงความสอดคล้องกันไว้
deletedDataPoint[].value[] list ค่าของช่องประเภทข้อมูลแต่ละประเภทสำหรับจุดข้อมูล คาดว่าแต่ละค่าที่เกี่ยวข้องกับช่องประเภทข้อมูลจะเกิดขึ้นในลำดับเดียวกันกับที่ช่องแสดงในประเภทข้อมูลที่ระบุไว้ในแหล่งข้อมูล

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

deletedDataPoint[].value[].intVal integer ค่าจำนวนเต็ม เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้
deletedDataPoint[].value[].fpVal double ค่าจุดทศนิยม เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้
deletedDataPoint[].value[].stringVal string ค่าสตริง เมื่อตั้งค่าแล้ว จะต้องกำหนดค่าอื่นๆ ไม่ได้ สตริงควรมีขนาดเล็กเมื่อเป็นไปได้ ระบบอาจสุ่มตัวอย่างสตรีมข้อมูลที่มีค่าสตริงมากและความถี่ของข้อมูลสูง
deletedDataPoint[].value[].mapVal[] list แมปค่า ควรมีการบันทึกพื้นที่คีย์และหน่วยที่ถูกต้องสำหรับค่าที่เกี่ยวข้องของแต่ละรายการไว้ในการกำหนดประเภทข้อมูล คีย์ควรมีขนาดเล็กเมื่อเป็นไปได้ ระบบอาจลดการสุ่มตัวอย่างสตรีมข้อมูลที่มีคีย์ขนาดใหญ่และความถี่ของข้อมูลสูง
deletedDataPoint[].value[].mapVal[].key string
deletedDataPoint[].value[].mapVal[].value nested object
deletedDataPoint[].value[].mapVal[].value.fpVal double ค่าจุดทศนิยม
deletedDataPoint[].modifiedTimeMillis long ระบุเวลาล่าสุดที่มีการแก้ไขจุดข้อมูลนี้ มีประโยชน์เฉพาะในบริบทที่เราแสดงการเปลี่ยนแปลงข้อมูลเท่านั้น แทนที่จะแสดงสถานะปัจจุบันของข้อมูล
deletedDataPoint[].rawTimestampNanos long การประทับเวลาดิบจาก SensorEvent ดั้งเดิม
deletedDataPoint[].computationTimeMillis long ห้ามใช้ช่องนี้ โดยระบบจะไม่สนใจและไม่เก็บข้อมูลไว้
nextPageToken string โทเค็นต่อเนื่อง ซึ่งใช้เพื่อเลื่อนดูชุดผลลัพธ์ขนาดใหญ่ ระบุค่านี้ในคำขอที่ตามมาเพื่อแสดงหน้าถัดไปของผลลัพธ์
dataSourceId string รหัสสตรีมข้อมูลของแหล่งข้อมูลที่มีการเปลี่ยนแปลงจุดข้อมูล

ลองใช้งาน

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