データセットは、データポイントの射影コンテナを表します。自分の個人情報は持ち運んでいません。データセットは、特定のデータソースから取得したデータポイントのセットを表します。データポイントは複数のデータセットに存在します。
このリソースのメソッドの一覧は、このページの最後に掲載されています。
リソース表現
{
"minStartTimeNs": long,
"maxEndTimeNs": long,
"dataSourceId": string,
"point": [
{
"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 |
このデータセットのポイントを作成したデータソースのデータ ストリーム ID。 | |
maxEndTimeNs |
long |
データセットの部分表現であるすべてのデータポイントの最大の終了時刻。時間はエポックからのナノ秒単位です。データセット識別子の 2 番目の部分とも一致する必要があります。 | |
minStartTimeNs |
long |
データセットの部分表現であるすべてのデータポイントの最小開始時刻。時間はエポックからのナノ秒単位です。データセット識別子の最初の部分とも一致する必要があります。 | |
nextPageToken |
string |
このトークンは、GET リクエストへのレスポンスとしてデータセットを受信し、データセットが大きすぎて単一のレスポンスに含めることができない場合に設定されます。このデータセット内のデータポイントの次のページを返すには、この値を後続の GET リクエストで指定します。 | |
point[] |
list |
データセットに含まれるデータポイントの部分的なリスト。endTimeNanos で並べ替えられています。このリストは、小さなデータセットを取得するときは完全であるとみなされます。また、データセットにパッチを適用するときや、大きすぎて 1 つのレスポンスに含めることができないデータセットを取得するときには部分的なリストとみなされます。 | |
point[].computationTimeMillis |
long |
この項目は使用しないでください。無視され、保存されません。 | |
point[].dataTypeName |
string |
このデータポイントの値の形式を定義するデータ型。 | |
point[].endTimeNanos |
long |
このデータポイントで表される間隔の終了時間（エポックからのナノ秒単位）。 | |
point[].modifiedTimeMillis |
long |
このデータポイントが最後に変更された時刻を示します。データの現在の状態を表すのではなく、データの変更を列挙するコンテキストでのみ有用です。 | |
point[].originDataSourceId |
string |
データポイントが派生データソースのデータセットに含まれている場合、このフィールドには、そのデータポイントを作成したデータソースのストリーム ID が入力されます。 警告: デバッグ以外の目的では、このフィールドを使用しないでください。このフィールドの値を設定していても、その値は実装の詳細であり、整合性が保証されるとは限りません。 |
|
point[].rawTimestampNanos |
long |
元の SensorEvent の未加工のタイムスタンプ。 | |
point[].startTimeNanos |
long |
このデータポイントで表される間隔の開始時刻。エポックからのナノ秒単位で指定します。 | |
point[].value[] |
list |
データポイントの各データ型フィールドの値。データ型フィールドに対応する各値は、データソースで指定されたデータ型でフィールドがリストされるのと同じ順序で出現することが期待されます。 データソースの型フィールド内にある列挙値に応じて、整数フィールドと浮動小数点フィールドのいずれか 1 つのみが入力されます。 |
|
point[].value[].fpVal |
double |
浮動小数点値。これが設定されている場合、他の値は設定できません。 | |
point[].value[].intVal |
integer |
整数値。これが設定されている場合、他の値は設定できません。 | |
point[].value[].mapVal[] |
list |
マップ値。各エントリの対応する値の有効なキースペースと単位は、データ型定義の一部として文書化する必要があります。鍵は可能な限り小さくする必要があります。キーのサイズが大きく、データ頻度が高いデータ ストリームは、ダウンサンプリングされる場合があります。 | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
浮動小数点値。 | |
point[].value[].stringVal |
string |
文字列値。これが設定されている場合、他の値は設定できません。文字列はできる限り小さくする必要があります。文字列値が大きく、データ頻度が高いデータ ストリームは、ダウンサンプリングされる場合があります。 |
メソッド
- delete
- 開始時間と終了時間を持つすべてのデータポイントを包括的に削除します
データセット ID で指定された期間と重複するほとんどの
データポイント全体が削除されます。データ型が
time span は一貫した値を表します（
com.google.activity.segment）、データポイントにまたがる データの重なり部分のみが含まれるため、 ポイントが削除されます。 - get
- 開始時間と終了時間を持つすべてのデータポイントを含むデータセットを返します データセットの最小開始時間と指定した範囲と 最大終了時刻を指定します具体的には、開始時間が データセットの終了時間と同等であり、終了時間がデータセットの終了時間以降である データセットの開始時間と同じになります
- patch
- データポイントをデータセットに追加します。このデータセットを事前に作成する必要はありません。
後続の呼び出しで、指定されたデータセット内のすべてのポイントが返されます
このデータセットを取得します。データポイントは複数のデータセットに属することができます。
この方法では、パッチのセマンティクスは使用しません。提供されるデータポイントは、 挿入されるだけで、既存のデータは置き換えられません。