Users.dataSources: update

Memperbarui sumber data yang ditentukan. Properti dataStreamId, dataType, type, dataStreamName, dan device dengan pengecualian version, tidak dapat diubah.

Sumber data diidentifikasi berdasarkan dataStreamId-nya. Coba sekarang.

Permintaan

Permintaan HTTP

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

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
dataSourceId string ID aliran data sumber data yang akan diperbarui.
userId string Perbarui sumber data untuk orang yang diidentifikasi. Gunakan me untuk menunjukkan pengguna yang diautentikasi. Hanya me yang didukung untuk saat ini.

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut:

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

Untuk informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, berikan resource Users.dataSources dengan properti berikut:

Nama properti Nilai Deskripsi Catatan
Properti yang Diperlukan
application nested object Informasi tentang aplikasi yang memasukkan data sensor ke platform.
application.name string Nama aplikasi ini. Ini diperlukan untuk klien REST, tetapi kami tidak menerapkan keunikan nama ini. Alat ini disediakan untuk memudahkan developer lain yang ingin mengidentifikasi REST mana yang membuat Aplikasi atau Sumber Data.
dataStreamId string ID unik untuk aliran data yang dihasilkan oleh sumber data ini. ID mencakup:

  • Produsen, model, dan nomor seri (UID) perangkat fisik.
  • Nama paket atau nama aplikasi. Nama paket digunakan saat sumber data dibuat oleh aplikasi Android. Nomor project developer digunakan saat sumber data dibuat oleh klien REST.
  • Jenis sumber data.
  • Nama aliran data sumber data.
Perlu diperhatikan bahwa tidak semua atribut sumber data digunakan sebagai bagian dari ID aliran data. Secara khusus, versi perangkat keras/aplikasi tidak digunakan. Hal ini memungkinkan kita untuk mempertahankan aliran data yang sama melalui update versi. Ini juga berarti bahwa dua objek DataSource dapat mewakili aliran data yang sama meskipun tidak sama.

Format persis ID aliran data yang dibuat oleh aplikasi Android adalah: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Format persis untuk ID aliran data yang dibuat oleh klien REST adalah: type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Jika salah satu kolom opsional yang membentuk ID aliran data tidak ada, kolom tersebut akan dihapus dari ID aliran data. ID aliran data minimum yang valid adalah: type:dataType.name:nomor project developer

Terakhir, nomor project developer dan UID perangkat di-obfuscate saat dibaca oleh klien REST atau Android mana pun yang tidak membuat sumber data. Hanya pembuat sumber data yang akan melihat nomor project developer dalam bentuk yang jelas dan normal. Artinya, klien akan melihat kumpulan data_stream_id yang berbeda dari klien lain dengan kredensial berbeda.

dataType nested object Jenis data menentukan skema untuk aliran data yang dikumpulkan, disisipkan ke dalam, atau dikueri dari Kebugaran API.
dataType.field[] list Kolom mewakili satu dimensi jenis data.
dataType.field[].format string Berbagai format yang didukung untuk setiap kolom dalam suatu jenis data.

Nilai yang dapat diterima adalah:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string Menentukan nama dan format data. Tidak seperti nama jenis data, nama kolom tidak diberi namespace, dan hanya harus unik dalam jenis data tersebut.
dataType.name string Setiap jenis data memiliki nama unik dengan namespace. Semua jenis data di namespace com.google dibagikan sebagai bagian dari platform.
device nested object Representasi perangkat terintegrasi (seperti ponsel atau perangkat wearable) yang dapat menyimpan sensor.
device.manufacturer string Produsen produk/hardware.
device.model string Nama model perangkat yang terlihat oleh pengguna akhir.
device.type string Konstanta yang mewakili jenis perangkat.

Nilai yang dapat diterima adalah:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string Nomor seri atau ID unik lainnya untuk hardware. Kolom ini di-obfuscate saat dibaca oleh klien REST atau Android mana pun yang tidak membuat sumber data. Hanya pembuat sumber data yang akan melihat kolom uid dalam bentuk yang jelas dan normal.

Obfuscation mempertahankan kesetaraan; yaitu, diberi dua ID, jika id1 == id2, di-obfuscate(id1) == di-obfuscate(id2).

device.version string String versi untuk hardware/software perangkat.
type string Konstanta yang menjelaskan jenis sumber data ini. Menunjukkan apakah sumber data ini menghasilkan data mentah atau turunan.

Nilai yang dapat diterima adalah:
  • "derived"
  • "raw"

Respons

Jika berhasil, metode ini akan menampilkan resource Users.dataSources dalam isi respons.

Cobalah!

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