資料集代表資料點的投影容器。他們不會提供任何個人資訊。資料集代表來自特定資料來源的一組資料點。可在一個以上的資料集中找到資料點。
如需本資源的方法清單,請見本頁結尾。
資源表示法
{ "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
),且資料點橫跨於資料集的兩端,系統只會刪除資料點的重疊部分。 - 取得
- 傳回包含的所有資料點,其中開始時間和結束時間與指定資料集最短開始時間和最大結束時間重疊。具體來說,任何資料點的開始時間小於或等於資料集結束時間,或是結束時間大於或等於資料集開始時間,
- 修補程式
- 將資料點新增至資料集。之前無須建立資料集。指定資料集中的所有資料點都會透過後續呼叫傳回,以擷取這個資料集。資料點可屬於多個資料集。
這個方法不使用修補程式語意:系統僅會插入資料點,而不會取代現有資料。