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 dari sumber data yang membuat set data.
userId string Buat daftar titik data untuk orang yang diidentifikasi. Gunakan me untuk menunjukkan pengguna yang diautentikasi. Hanya me yang didukung untuk saat ini.
Parameter kueri opsional
limit integer Jika ditentukan, tidak lebih dari perubahan titik data ini akan disertakan dalam respons.
pageToken string Token lanjutan, yang digunakan untuk menelusuri kumpulan hasil yang besar. Untuk mendapatkan 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 menyediakan isi permintaan dengan metode ini.

Tanggapan

Jika berhasil, metode ini 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 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.
insertedDataPoint[].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.

insertedDataPoint[].value[].intVal integer Nilai bilangan bulat. Jika hal ini ditetapkan, nilai lain tidak boleh ditetapkan.
insertedDataPoint[].value[].fpVal double Nilai floating point. Jika hal ini ditetapkan, nilai lain tidak boleh ditetapkan.
insertedDataPoint[].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.
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 tetap berukuran kecil jika memungkinkan. Aliran data dengan kunci besar dan frekuensi data tinggi mungkin dikurangi sampelnya.
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 tempat kami 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. Daftar tersebut diabaikan dan tidak disimpan.
deletedDataPoint[] list Titik data untuk pengguna dihapus. Catatan, untuk modifikasi, nilai ini harus diuraikan 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 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.
deletedDataPoint[].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.

deletedDataPoint[].value[].intVal integer Nilai bilangan bulat. Jika hal ini ditetapkan, nilai lain tidak boleh ditetapkan.
deletedDataPoint[].value[].fpVal double Nilai floating point. Jika hal ini ditetapkan, nilai lain tidak boleh ditetapkan.
deletedDataPoint[].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.
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 tetap berukuran kecil jika memungkinkan. Aliran data dengan kunci besar dan frekuensi data tinggi mungkin dikurangi sampelnya.
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 tempat kami 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. Daftar tersebut diabaikan dan tidak disimpan.
nextPageToken string Token lanjutan, yang digunakan untuk menelusuri 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 live dan melihat responsnya.