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 を使ってライブデータ上でこのメソッドを呼び出し、レスポンスを確認します。