Set data mewakili penampung proyeksi untuk titik data. Perangkat tersebut tidak memiliki informasi sendiri. Set data mewakili kumpulan titik data dari sumber data tertentu. Satu titik data dapat ditemukan di lebih dari satu set data.
Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.
Representasi resource
{
"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
}
| Nama properti | Nilai | Deskripsi | Catatan |
|---|---|---|---|
dataSourceId |
string |
ID aliran data sumber data yang membuat titik-titik dalam set data ini. | |
maxEndTimeNs |
long |
Waktu berakhir terbesar dari semua titik data dalam kemungkinan representasi set data sebagian ini. Waktu dalam nanodetik dari epoch. Nilai ini juga harus cocok dengan bagian kedua dari ID set data. | |
minStartTimeNs |
long |
Waktu mulai terkecil dari semua titik data dalam kemungkinan representasi set data ini. Waktu dalam nanodetik dari epoch. Bagian ini juga harus cocok dengan bagian pertama ID set data. | |
nextPageToken |
string |
Token ini akan ditetapkan ketika set data diterima sebagai respons terhadap permintaan GET dan set data terlalu besar untuk disertakan dalam satu respons. Berikan nilai ini dalam permintaan GET berikutnya untuk menampilkan halaman titik data berikutnya dalam set data ini. | |
point[] |
list |
Daftar sebagian dari titik data yang terdapat dalam set data, diurutkan berdasarkan endTimeNanos. Daftar ini dianggap lengkap ketika mengambil set data kecil dan sebagian saat melakukan patch pada set data atau mengambil set data yang terlalu besar untuk disertakan dalam satu respons. | |
point[].computationTimeMillis |
long |
JANGAN GUNAKAN KOLOM INI. File akan diabaikan dan tidak disimpan. | |
point[].dataTypeName |
string |
Jenis data yang menentukan format nilai dalam titik data ini. | |
point[].endTimeNanos |
long |
Waktu berakhir interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch. | |
point[].modifiedTimeMillis |
long |
Menunjukkan waktu terakhir kali titik data ini diubah. Hanya berguna dalam konteks tempat kami mencantumkan perubahan data, bukan mewakili status data saat ini. | |
point[].originDataSourceId |
string |
Jika titik data berada dalam set data untuk sumber data turunan, kolom ini akan diisi dengan ID aliran data sumber data yang membuat titik data awalnya. PERINGATAN: jangan mengandalkan kolom ini untuk hal lain selain proses debug. Nilai kolom ini, jika ditetapkan sama sekali, adalah detail implementasi dan tidak dijamin akan tetap konsisten. |
|
point[].rawTimestampNanos |
long |
Stempel waktu mentah dari SensorEvent asli. | |
point[].startTimeNanos |
long |
Waktu mulai interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch. | |
point[].value[] |
list |
Nilai setiap kolom jenis data untuk titik data. Setiap nilai yang sesuai dengan kolom jenis data diharapkan akan muncul dalam urutan yang sama seperti kolom yang dicantumkan dalam jenis data yang ditentukan dalam sumber data. Hanya salah satu kolom bilangan bulat dan floating point yang akan diisi, bergantung pada nilai enum format dalam kolom jenis sumber data. |
|
point[].value[].fpVal |
double |
Nilai floating point. Jika ini ditetapkan, nilai lain tidak boleh ditetapkan. | |
point[].value[].intVal |
integer |
Nilai bilangan bulat. Jika ini ditetapkan, nilai lain tidak boleh ditetapkan. | |
point[].value[].mapVal[] |
list |
Nilai peta. Ruang dan unit kunci yang valid untuk nilai yang sesuai dari setiap entri harus didokumentasikan sebagai bagian dari definisi tipe data. Kunci harus berukuran kecil bila memungkinkan. Aliran data dengan kunci besar dan frekuensi data yang tinggi mungkin tidak diambil sampelnya. | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
Nilai floating point. | |
point[].value[].stringVal |
string |
Nilai string. Jika ini ditetapkan, nilai lain tidak boleh ditetapkan. String harus dijaga agar tetap kecil jika memungkinkan. Aliran data dengan nilai string yang besar dan frekuensi data yang tinggi mungkin diambil sampelnya. |
Metode
- hapus
- Melakukan penghapusan inklusif untuk semua titik data yang waktu mulai dan waktunya
bertumpang-tindih dengan rentang waktu yang ditentukan oleh ID set data. Untuk sebagian besar jenis data, seluruh titik data akan dihapus. Untuk jenis data yang
rentang waktunya mewakili nilai yang konsisten (seperti
com.google.activity.segment), dan sebuah titik data membagi salah satu titik akhir set data, hanya bagian tumpang-tindih dari titik data yang akan dihapus. - dapatkan
- Menampilkan set data yang berisi semua titik data dengan waktu mulai dan waktu berakhir yang tumpang-tindih dengan rentang waktu mulai minimum dan waktu berakhir maksimum set data yang ditentukan. Khususnya, setiap titik data yang waktu mulainya lebih kecil dari atau sama dengan waktu berakhir set data, dan yang waktu berakhirnya lebih besar atau sama dengan waktu mulai set data.
- patch
- Menambahkan titik data ke set data. Set data tidak perlu dibuat sebelumnya.
Semua titik dalam set data yang diberikan akan ditampilkan dengan panggilan berikutnya untuk mengambil set data ini. Titik data dapat dimiliki oleh lebih dari satu {i>dataset<i}.
Metode ini tidak menggunakan semantik patch: titik data yang disediakan hanya disisipkan, tanpa diganti data yang sudah ada.