Users.dataSources.dataPointChanges: list

查詢使用者資料點的特定資料來源有變化。 立即試用。

要求

HTTP 要求

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

參數

參數名稱 值 說明
路徑參數
dataSourceId string 建立資料集的資料來源資料串流 ID。
userId string 列出識別對象的資料點。使用 me 表示 通過驗證的使用者目前僅支援 me。
選用的查詢參數
limit integer 如有指定，您最多只能包含此次資料點變更 回應。
pageToken string 用於逐頁瀏覽大型結果集的接續權杖。 如要取得下一頁的結果，請將此參數設為 前一則回覆的 nextPageToken。

授權

這項要求需要授權，且至少要有下列其中一個範圍：

範圍
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 如果衍生資料來源的資料集包含資料點，這個欄位就會填入最初建立資料點的資料來源串流 ID。

警告：請勿將這個欄位用於偵錯以外的用途。這個欄位的值如果設定完成，就會是實作詳細資料，不保證會保持一致。
insertedDataPoint[].value[] list 資料點的每個資料類型欄位值。對應至資料類型欄位的每個值通常會按照該欄位在資料來源指定的資料類型列出的順序排列。

視資料來源類型欄位中的格式列舉值而定，系統只會填入整數和浮點欄位的其中一個。
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 如果衍生資料來源的資料集包含資料點，這個欄位就會填入最初建立資料點的資料來源串流 ID。

警告：請勿將這個欄位用於偵錯以外的用途。這個欄位的值如果設定完成，就會是實作詳細資料，不保證會保持一致。
deletedDataPoint[].value[] list 資料點的每個資料類型欄位值。對應至資料類型欄位的每個值通常會按照該欄位在資料來源指定的資料類型列出的順序排列。

視資料來源類型欄位中的格式列舉值而定，系統只會填入整數和浮點欄位的其中一個。
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 資料點變更的資料來源 ID。

試試看！

使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。