データセットは、データポイントの射影コンテナを表します。顧客自身の情報はありません。データセットは、特定のデータソースからのデータポイントのセットを表します。データポイントは、複数のデータセットに含まれています。
このリソースのメソッドの一覧は、このページの最後に掲載されています。
リソースの表記
{ "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 |
データセットのこの部分的な表現における、すべてのデータポイントの最大終了時間。エポックからのナノ秒単位の時間です。これは、データセット識別子の後半部分とも一致する必要があります。 | |
minStartTimeNs |
long |
データセットの部分的な表現で、すべてのデータポイントの最小開始時刻。エポックからのナノ秒単位の時間です。これは、データセット ID の最初の部分とも一致する必要があります。 | |
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 |
文字列値。設定する場合は、他の値を設定しないでください。文字列は可能な限り小さくする必要があります。文字列値が大きく、データ頻度が高いデータ ストリームは、ダウンサンプリングされる可能性があります。 |
Methods
- delete
- 開始時間と終了時間がデータセット ID で指定された期間と重複するすべてのデータポイントを包括的に削除します。ほとんどのデータ型で、データポイント全体が削除されます。期間が一貫した値(
com.google.activity.segment
など)を表し、データポイントがデータセットのいずれかのエンドポイントにまたがる場合は、データポイントの重複する部分のみが削除されます。 - get
- 開始時間と終了時間が、データセットの最小開始時間と最大終了時間の指定範囲と重なるすべてのデータポイントを含むデータセットを返します。具体的には、開始時間がデータセットの終了時間以下で、終了時間がデータセットの開始時間以降のすべてのデータポイントです。
- パッチ
- データセットにデータポイントを追加します。事前にデータセットを作成しておく必要はありません。指定したデータセット内のすべてのポイントが返され、その後は、このデータセットを取得するための呼び出しが行われます。データポイントは複数のデータセットに属することができます。
このメソッドはパッチのセマンティクスを使用しません。提供されたデータポイントは挿入のみで、既存のデータは置き換えられません。