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 เวลาเริ่มต้นของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น
insertedDataPoint[].endTimeNanos long เวลาสิ้นสุดของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น
insertedDataPoint[].dataTypeName string ประเภทข้อมูลที่กําหนดรูปแบบของค่าในจุดข้อมูลนี้
insertedDataPoint[].originDataSourceId string หากจุดข้อมูลอยู่ในชุดข้อมูลสําหรับแหล่งข้อมูลที่ได้รับข้อมูล ช่องนี้จะสร้างขึ้นด้วยรหัสสตรีมของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก

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

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

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 เวลาเริ่มต้นของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น
deletedDataPoint[].endTimeNanos long เวลาสิ้นสุดของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น
deletedDataPoint[].dataTypeName string ประเภทข้อมูลที่กําหนดรูปแบบของค่าในจุดข้อมูลนี้
deletedDataPoint[].originDataSourceId string หากจุดข้อมูลอยู่ในชุดข้อมูลสําหรับแหล่งข้อมูลที่ได้รับข้อมูล ช่องนี้จะสร้างขึ้นด้วยรหัสสตรีมของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก

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

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

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 ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลสดและดูคําตอบ