Users.dataSources.datasets

Set data mewakili penampung proyeksi untuk titik data. Properti tersebut tidak memiliki info apa pun. Set data mewakili kumpulan titik data dari sumber data tertentu. Satu titik data dapat ditemukan di lebih dari satu set data.

Untuk 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 dalam set data ini.
maxEndTimeNs long Waktu berakhir terbesar dari semua titik data dalam kemungkinan representasi parsial dari set data ini. Waktu dalam nanodetik dari epoch. Ini juga harus cocok dengan bagian kedua dari pengidentifikasi {i>dataset<i}.
minStartTimeNs long Waktu mulai terkecil dari semua titik data dalam kemungkinan representasi parsial dari set data ini. Waktu dalam nanodetik dari epoch. Ini juga harus cocok dengan bagian pertama dari pengidentifikasi {i>dataset<i}.
nextPageToken string Token ini akan ditetapkan saat set data diterima sebagai respons atas 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 titik data yang terdapat dalam set data, diurutkan oleh endTimeNanos. Daftar ini dianggap lengkap saat mengambil set data kecil dan sebagian saat mem-patch set data atau mengambil set data yang terlalu besar untuk disertakan dalam satu respons.
point[].computationTimeMillis long JANGAN GUNAKAN KOLOM INI. Pesan 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 titik data ini diubah. Hanya berguna dalam konteks di mana kita mencantumkan perubahan data, bukan mewakili status data saat ini.
point[].originDataSourceId string Jika titik data terdapat dalam set data untuk sumber data turunan, kolom ini akan diisi dengan ID aliran data sumber data yang awalnya membuat titik data tersebut.

PERINGATAN: jangan mengandalkan kolom ini untuk hal apa pun selain proses debug. Nilai kolom ini, jika ditetapkan sama sekali, merupakan 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 di jenis data yang ditentukan di sumber data.

Hanya salah satu kolom bilangan bulat dan kolom floating point yang akan diisi, bergantung pada nilai enum format dalam kolom jenis sumber data.

point[].value[].fpVal double Nilai floating point. Jika kebijakan ini disetel, nilai lain tidak boleh ditetapkan.
point[].value[].intVal integer Nilai bilangan bulat. Jika kebijakan ini disetel, 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 jenis data. Kunci harus berukuran kecil jika memungkinkan. Aliran data dengan kunci besar dan frekuensi data yang tinggi mungkin diambil sampelnya sedikit.
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 kebijakan ini disetel, nilai lain tidak boleh ditetapkan. String harus selalu kecil jika memungkinkan. Aliran data dengan nilai string yang besar dan frekuensi data yang tinggi mungkin diambil sampelnya sedikit.

Metode

hapus
Melakukan penghapusan inklusif terhadap semua titik data yang waktu mulai dan berakhirnya tumpang tindih dengan rentang waktu yang ditentukan oleh ID set data. Untuk sebagian besar tipe data, seluruh titik data akan dihapus. Untuk jenis data di mana rentang waktu mewakili nilai yang konsisten (seperti com.google.activity.segment), dan titik data akan menyebar salah satu titik akhir {i>dataset<i}, hanya bagian data yang tumpang tindih titik akan dihapus.
dapatkan
Menampilkan set data yang berisi semua titik data yang waktu mulai dan berakhirnya tumpang tindih dengan rentang waktu mulai minimum set data yang ditentukan waktu berakhir maksimum. Khususnya, setiap titik data yang waktu mulainya lebih singkat dari atau sama dengan waktu berakhir set data dan yang waktu berakhir lebih besar dari 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 tambahan untuk mengambil {i>dataset <i}ini. Titik data dapat dimiliki oleh lebih dari satu {i>dataset<i}.

Metode ini tidak menggunakan semantik patch: titik data yang disediakan adalah hanya disisipkan, tanpa ada data yang diganti.