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。

承認

このリクエストは、少なくとも次のうち 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 データポイントが派生データソースのデータセットに含まれている場合、このフィールドには、そのデータポイントを作成したデータソースのストリーム ID が入力されます。

警告: デバッグ以外の目的では、このフィールドを使用しないでください。このフィールドの値を設定していても、その値は実装の詳細であり、整合性が保証されるとは限りません。
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 データポイントが派生データソースのデータセットに含まれている場合、このフィールドには、そのデータポイントを作成したデータソースのストリーム ID が入力されます。

警告: デバッグ以外の目的では、このフィールドを使用しないでください。このフィールドの値を設定していても、その値は実装の詳細であり、整合性が保証されるとは限りません。
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 データポイントが変更されたデータソースのデータ ストリーム ID。

試してみよう:

以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。