データセットは、データポイントの投影コンテナを表します。自分自身の情報を持っていない。データセットは、特定のデータソースからのデータポイントのセットを表します。データポイントは複数のデータセットで見つけることができます。
このリソースのメソッドの一覧は、このページの最後に掲載されています。
リソースの表記
{ "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 リクエストへのレスポンスとしてデータセットが受信され、そのデータセットが大きすぎて 1 つのレスポンスに含めることができない場合に設定されます。後続の 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 で指定された期間と重複するすべてのデータポイントを包括的に削除します。ほとんどのデータ型では、データポイント全体が削除されます。期間が一貫した値を表し(
com.google.activity.segment
など)、データポイントがデータセットのいずれかのエンドポイントをまたぐデータ型の場合、データポイントの重複部分のみが削除されます。 - get
- 開始時間と終了時間が、指定されたデータセットの最小開始時間と最大終了時間と重複するすべてのデータポイントを含むデータセットを返します。具体的には、開始時間がデータセットの終了時間と同じかそれより短く、終了時間がデータセットの開始時間以降のデータポイントです。
- patch
- データセットにデータポイントを追加します。データセットを事前に作成しておく必要はありません。後続の呼び出しにより、指定されたデータセット内のすべてのポイントが返されます。データポイントは複数のデータセットに属することができます。
このメソッドはパッチのセマンティクスを使用しません。指定されたデータポイントは挿入されるだけで、既存のデータは置換されません。