Users.dataSources.dataPointChanges: list

Kueri untuk titik data pengguna berubah untuk sumber data tertentu. Coba sekarang.

Permintaan

Permintaan HTTP

GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
dataSourceId string ID aliran data sumber data yang membuat set data.
userId string Buat daftar titik data untuk orang yang diidentifikasi. Gunakan me untuk menunjukkan pengguna yang terautentikasi. Saat ini hanya me yang didukung.
Parameter kueri opsional
limit integer Jika ditentukan, tidak lebih dari jumlah perubahan titik data yang akan disertakan dalam responsnya.
pageToken string Token kelanjutan, yang digunakan untuk melakukan page melalui kumpulan hasil yang besar. Untuk membuka halaman hasil berikutnya, tetapkan parameter ini ke nilai nextPageToken dari respons sebelumnya.

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut:

Cakupan
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
https://www.googleapis.com/auth/fitness.body.read
https://www.googleapis.com/auth/fitness.body.write
https://www.googleapis.com/auth/fitness.nutrition.read
https://www.googleapis.com/auth/fitness.nutrition.write
https://www.googleapis.com/auth/fitness.blood_pressure.read
https://www.googleapis.com/auth/fitness.blood_pressure.write
https://www.googleapis.com/auth/fitness.blood_glucose.read
https://www.googleapis.com/auth/fitness.blood_glucose.write
https://www.googleapis.com/auth/fitness.oxygen_saturation.read
https://www.googleapis.com/auth/fitness.oxygen_saturation.write
https://www.googleapis.com/auth/fitness.body_temperature.read
https://www.googleapis.com/auth/fitness.body_temperature.write
https://www.googleapis.com/auth/fitness.reproductive_health.read
https://www.googleapis.com/auth/fitness.reproductive_health.write

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Jangan berikan isi permintaan dengan metode ini.

Respons

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "insertedDataPoint": [
    {
      "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
    }
  ],
  "deletedDataPoint": [
    {
      "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
}
Nama properti Nilai Deskripsi Catatan
insertedDataPoint[] list Titik data yang disisipkan untuk pengguna.
insertedDataPoint[].startTimeNanos long Waktu mulai interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch.
insertedDataPoint[].endTimeNanos long Waktu berakhir interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch.
insertedDataPoint[].dataTypeName string Jenis data yang menentukan format nilai dalam titik data ini.
insertedDataPoint[].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.
insertedDataPoint[].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.

insertedDataPoint[].value[].intVal integer Nilai bilangan bulat. Jika kebijakan ini disetel, nilai lain tidak boleh ditetapkan.
insertedDataPoint[].value[].fpVal double Nilai floating point. Jika kebijakan ini disetel, nilai lain tidak boleh ditetapkan.
insertedDataPoint[].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.
insertedDataPoint[].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.
insertedDataPoint[].value[].mapVal[].key string
insertedDataPoint[].value[].mapVal[].value nested object
insertedDataPoint[].value[].mapVal[].value.fpVal double Nilai floating point.
insertedDataPoint[].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.
insertedDataPoint[].rawTimestampNanos long Stempel waktu mentah dari SensorEvent asli.
insertedDataPoint[].computationTimeMillis long JANGAN GUNAKAN KOLOM INI. Pesan diabaikan dan tidak disimpan.
deletedDataPoint[] list Titik data pengguna dihapus. Catatan, untuk modifikasi, parameter ini harus diurai sebelum menangani penyisipan.
deletedDataPoint[].startTimeNanos long Waktu mulai interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch.
deletedDataPoint[].endTimeNanos long Waktu berakhir interval yang diwakili oleh titik data ini, dalam nanodetik sejak epoch.
deletedDataPoint[].dataTypeName string Jenis data yang menentukan format nilai dalam titik data ini.
deletedDataPoint[].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.
deletedDataPoint[].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.

deletedDataPoint[].value[].intVal integer Nilai bilangan bulat. Jika kebijakan ini disetel, nilai lain tidak boleh ditetapkan.
deletedDataPoint[].value[].fpVal double Nilai floating point. Jika kebijakan ini disetel, nilai lain tidak boleh ditetapkan.
deletedDataPoint[].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.
deletedDataPoint[].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.
deletedDataPoint[].value[].mapVal[].key string
deletedDataPoint[].value[].mapVal[].value nested object
deletedDataPoint[].value[].mapVal[].value.fpVal double Nilai floating point.
deletedDataPoint[].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.
deletedDataPoint[].rawTimestampNanos long Stempel waktu mentah dari SensorEvent asli.
deletedDataPoint[].computationTimeMillis long JANGAN GUNAKAN KOLOM INI. Pesan diabaikan dan tidak disimpan.
nextPageToken string Token kelanjutan, yang digunakan untuk melakukan page melalui kumpulan hasil yang besar. Berikan nilai ini dalam permintaan berikutnya untuk menampilkan halaman hasil berikutnya.
dataSourceId string ID aliran data sumber data dengan perubahan titik data.

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.