データセットにデータポイントを追加します。データセットを事前に作成しておく必要はありません。後続の呼び出しにより、指定されたデータセット内のすべてのポイントが返されます。データポイントは複数のデータセットに属することができます。
このメソッドはパッチのセマンティクスを使用しません。指定されたデータポイントは挿入されるだけで、既存のデータは置換されません。こちらから今すぐお試しください。
リクエスト
HTTP リクエスト
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
パスパラメータ | ||
dataSourceId |
string |
データセットを作成したデータソースのデータ ストリーム ID。 |
datasetId |
string |
このフィールドは使用されないため、省略しても問題ありません。 |
userId |
string |
特定した人物のデータセットにパッチを適用します。me を使用して、認証済みユーザーを示します。現時点では me のみがサポートされています。
|
認可
このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。
範囲 |
---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
詳細については、認証と認可のページをご覧ください。
リクエスト本文
リクエストの本文には、パッチ セマンティクスのルールに従って、次のプロパティを使用して Users.dataSources.datasets リソースの関連部分を指定します。
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
必須プロパティ | |||
dataSourceId |
string |
このデータセット内にポイントを作成したデータソースのデータ ストリーム ID。 | |
maxEndTimeNs |
long |
データセットのこの部分的な表現である可能性のあるすべてのデータポイントの最大終了時間。時間はエポックからのナノ秒単位です。また、データセット識別子の 2 番目の部分とも一致する必要があります。 | |
minStartTimeNs |
long |
データセットの部分表現である可能性のあるすべてのデータポイントの最小開始時間。時間はエポックからのナノ秒単位です。また、データセット識別子の最初の部分と一致する必要があります。 | |
point[] |
list |
データセットに含まれるデータポイントのリスト。endTimeNanos で並べ替えられます。このリストは、小規模なデータセットを取得する場合は完全とみなされ、データセットにパッチを適用する場合や、大きすぎて 1 つのレスポンスに含めることができないデータセットを取得する場合は部分的と見なされます。 | |
point[].dataTypeName |
string |
このデータポイントの値の形式を定義するデータ型。 | |
point[].endTimeNanos |
long |
このデータポイントで表される期間の終了時間(エポックからのナノ秒単位)。 | |
point[].startTimeNanos |
long |
このデータポイントで表される期間の開始時間(エポックからのナノ秒単位)。 | |
point[].value[] |
list |
データポイントの各データ型フィールドの値。データ型フィールドに対応する各値は、データソースで指定されたデータ型のフィールドがリストされているのと同じ順序で出現することが想定されています。 データソースのタイプ フィールド内の形式の列挙値に応じて、整数フィールドまたは浮動小数点フィールドのいずれか 1 つのみが入力されます。 |
レスポンス
成功すると、このメソッドはレスポンスの本文で Users.dataSources.datasets リソースを返します。
試してみよう:
以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認してください。