資料集代表資料點的投影容器。但不會透露自己的任何資訊。資料集代表特定資料來源的一組資料點。一個資料點可在多個資料集中找到。
如需本資源的方法清單，請見本頁結尾。
資源表示法
{
"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 |
在這個類別中，所有資料點的最長結束時間，可能是資料集的一部分。時間以 Epoch 紀元時間起算的奈秒為單位。也應與資料集 ID 的第二部分相符。 | |
minStartTimeNs |
long |
在這個物件中，所有資料點的最小開始時間可能代表資料集的部分內容。時間以 Epoch 紀元時間起算的奈秒為單位。也應與資料集 ID 的第一部分相符。 | |
nextPageToken |
string |
收到資料集來回應 GET 要求，且資料集過大，無法納入單一回應時，就會設定這個權杖。在後續的 GET 要求中提供這個值，以傳回此資料集內的下一頁資料點。 | |
point[] |
list |
資料集中包含的部分資料點清單，依 endTimeNanos 排序。當您擷取小型資料集時，如果只修補資料集或擷取的資料集過大，無法納入單一回應，這份清單將視為完整。 | |
point[].computationTimeMillis |
long |
請勿使用此欄位。系統會忽略且不會儲存。 | |
point[].dataTypeName |
string |
定義這個資料點中值格式的資料類型。 | |
point[].endTimeNanos |
long |
這個資料點代表的間隔結束時間，以 Epoch 紀元時間起算的奈秒為單位。 | |
point[].modifiedTimeMillis |
long |
指出此資料點上次修改的時間。僅適用於列出資料變更的情況，而非代表資料目前狀態的情況。 | |
point[].originDataSourceId |
string |
如果資料點包含在衍生資料來源的資料集中，這個欄位會填入原先建立資料點的資料來源串流 ID。 警告：除了偵錯之外，請勿將這個欄位用於其他用途。如果這個欄位已設定，則會是實作的詳細資料，不保證會維持一致。 |
|
point[].rawTimestampNanos |
long |
原始 SensorEvent 的原始時間戳記。 | |
point[].startTimeNanos |
long |
這個資料點代表的間隔開始時間，以 Epoch 紀元時間起算的奈秒為單位。 | |
point[].value[] |
list |
資料點中每個資料類型欄位的值。每個與資料類型欄位對應的值，系統都會按照該欄位在資料來源指定的資料類型中的排列順序出現。 視資料來源類型欄位中的格式列舉值而定，系統只會填入一個整數和浮點欄位。 |
|
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 |
字串值。設定此屬性時，不得設定其他值。建議盡可能精簡字串。字串值與高資料頻率的資料串流可能會降低取樣。 |
方法
- 刪除
- 針對開始時間和結束時間與資料集 ID 指定時間範圍重疊的所有資料點執行多元包容刪除。大部分資料類型都會刪除整個資料點。對於時間範圍代表一致的值的資料類型 (例如
com.google.activity.segment)，且資料點橫跨資料集任一端點，則系統只會刪除資料點的重疊部分。 - get
- 傳回含有所有資料點的資料集，這些資料點的起點和結束時間與資料集最短開始時間和結束時間的指定範圍重疊。具體來說，開始時間小於或等於資料集結束時間，且結束時間大於或等於資料集開始時間的任何資料點。
- 修補程式
- 在資料集中加入資料點。先前不一定要建立資料集。
系統將傳回指定資料集內的所有點，同時發出子呼叫來擷取這個資料集。資料點可以屬於多個資料集。
這個方法不使用修補語意：系統只會插入提供的資料點，不會取代現有資料。