Users.dataSources: create

Membuat sumber data baru yang unik di semua sumber data milik kepada pengguna ini.

Sumber data adalah sumber unik dari data sensor. Sumber data dapat mengekspos data mentah yang berasal dari sensor hardware di perangkat lokal atau pendamping. Mereka juga dapat mengekspos data turunan, yang dibuat dengan mengubah atau menggabungkan data lainnya sumber. Beberapa sumber data dapat tersedia untuk jenis data yang sama. Setiap data di setiap set data yang dimasukkan ke dalam atau dibaca dari Fitness API memiliki sumber data yang terkait.

Setiap sumber data menghasilkan aliran unik pembaruan set data, dengan ID sumber data unik. Tidak semua perubahan pada sumber data memengaruhi ID aliran data, sehingga data yang dikumpulkan oleh versi terupdate dari aplikasi/perangkat masih dapat dianggap sebagai milik data yang sama sumber.

Sumber data diidentifikasi menggunakan string yang dihasilkan oleh server, berdasarkan pada konten sumber yang dibuat. dataStreamId kolom tidak boleh diatur saat memanggil metode ini. Ini akan dibuat secara otomatis oleh server dengan format yang benar. Jika dataStreamId disetel, dan harus sesuai dengan format yang apa yang akan dihasilkan oleh server Anda. Format ini adalah kombinasi beberapa {i>field<i} dari sumber data, dan memiliki urutan tertentu. Jika tidak cocok, permintaan akan gagal dengan pesan {i>error<i}.

Menentukan DataType yang bukan jenis yang diketahui (dimulai dengan "com.google.") akan membuat DataSource dengan jenis data kustom. Jenis data kustom hanya dapat dibaca oleh aplikasi yang membuatnya. Jenis data kustom tidak digunakan lagi; menggunakan tipe data standar sebagai gantinya.

Selain kolom sumber data yang disertakan dalam ID sumber data, ID nomor proyek pengembang yang diotentikasi saat membuat data sumber disertakan. Nomor project developer ini di-obfuscate saat dibaca oleh pengembang lain yang membaca tipe data publik. Coba sekarang.

Permintaan

Permintaan HTTP

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

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
userId string Buat sumber data untuk orang yang diidentifikasi. Gunakan me untuk menunjukkan pengguna yang telah diotentikasi. Hanya me yang didukung saat ini baik.

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 mengetahui 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 dalam platform.
application.name string Nama aplikasi ini. Ini diperlukan untuk klien REST, tetapi kami tidak menerapkan keunikan nama ini. ID ini disediakan untuk memudahkan developer lain yang ingin mengidentifikasi REST mana yang membuat Aplikasi atau Sumber Data.
dataType nested object Jenis data menentukan skema untuk aliran data yang dikumpulkan, dimasukkan ke, atau dikueri dari Fitness API.
dataType.field[] list Kolom mewakili satu dimensi dari jenis data.
dataType.field[].format string Berbagai format yang didukung untuk setiap kolom dalam jenis data.

Nilai yang dapat diterima:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string Mendefinisikan nama dan format data. Tidak seperti nama jenis data, nama kolom tidak diberi namespace, dan hanya perlu unik dalam jenis data.
dataType.name string Setiap jenis data memiliki nama yang unik dan 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 menampung 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:
  • "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 Android atau REST apa 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, diberikan dua ID, jika id1 == id2, disamarkan(id1) == 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:
  • "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 langsung dan melihat responsnya.