資料集代表資料點的投影容器。他們不會攜帶任何個人資訊。資料集代表特定資料來源的一組資料點。同一個資料點會出現在多個資料集中。
如需本資源的方法清單，請見本頁結尾。
資源表示法
{
"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) 和資料點重疊 是資料集的任一終點，只有資料重疊的部分 點將遭到刪除。 - 取得
- 傳回資料集，其中含有開始和結束時間的所有資料點 與資料集的最短開始時間重疊， 結束時間上限。具體來說，任何資料點的開始時間較小 等於或等於資料集結束時間，且結束時間大於或等於資料集 等於資料集開始時間。
- 修補程式
- 在資料集中加入資料點。不一定要事先建立資料集。
指定資料集中的所有點都會與後續的呼叫一併傳回
擷取此資料集。資料點可屬於多個資料集。
這個方法不使用修補語意：提供的資料點 插入文字，且沒有替換現有資料。