Users.dataSources.datasets

Set data mewakili container proyeksi untuk titik data. Keduanya tidak memiliki info sendiri. Set data mewakili set titik data dari sumber data tertentu. Titik data dapat ditemukan di beberapa set data.

Untuk daftar metode bagi 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 dari sumber data yang membuat titik dalam set data ini.
maxEndTimeNs long Waktu berakhir terbesar dari semua titik data dalam representasi sebagian data ini yang mungkin sebagian. Waktu dalam nanodetik dari epoch. ID ini juga harus cocok dengan bagian kedua dari ID set data.
minStartTimeNs long Waktu mulai terkecil dari semua titik data dalam representasi sebagian set data ini. Waktu dalam nanodetik dari epoch. ID ini juga harus cocok dengan bagian pertama ID set data.
nextPageToken string Token ini akan ditetapkan saat 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 titik data yang terdapat dalam set data, diurutkan berdasarkan endTimeNanos. Daftar ini dianggap lengkap saat mengambil set data kecil dan sebagian saat menambal set data atau mengambil set data yang terlalu besar untuk disertakan dalam satu respons.
point[].computationTimeMillis long JANGAN GUNAKAN KOLOM INI. Daftar tersebut 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 tempat kami 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 yang membuat titik data tersebut.

PERINGATAN: jangan mengandalkan kolom ini untuk hal lain selain proses debug. Nilai kolom ini, jika ditetapkan, 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 terjadi dalam urutan yang sama dengan kolom yang dicantumkan dalam jenis data yang ditentukan dalam sumber data.

Hanya 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 hal ini ditetapkan, nilai lain tidak boleh ditetapkan.
point[].value[].intVal integer Nilai bilangan bulat. Jika hal 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 jenis data. Kunci harus tetap berukuran kecil jika memungkinkan. Aliran data dengan kunci besar dan frekuensi data tinggi mungkin dikurangi 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 hal ini ditetapkan, nilai lain tidak boleh ditetapkan. Jika memungkinkan, string harus selalu berukuran kecil. Aliran data dengan nilai string besar dan frekuensi data tinggi dapat dihapus dari sampel.

Metode

hapus
Melakukan penghapusan inklusif untuk semua titik data yang waktu mulai dan waktunya tumpang-tindih dengan rentang waktu yang ditentukan oleh ID set data. Untuk sebagian besar jenis data, seluruh titik data akan dihapus. Untuk jenis data dengan rentang waktu merepresentasikan nilai yang konsisten (seperti com.google.activity.segment), dan titik data berada di salah satu titik akhir set data, hanya bagian titik data yang tumpang-tindih yang akan dihapus.
dapatkan
Menampilkan set data yang berisi semua titik data yang waktu mulai dan waktunya tumpang tindih dengan rentang waktu mulai minimum dan waktu berakhir maksimum set data yang ditentukan. Secara khusus, setiap titik data yang waktu mulainya kurang dari atau sama dengan waktu berakhir set data dan waktu akhirnya yang 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 tertentu akan ditampilkan dengan panggilan selanjutnya untuk mengambil set data ini. Titik data dapat dimiliki oleh lebih dari satu set data.

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