Membuat sumber data baru yang unik di semua sumber data milik pengguna ini.
Sumber data adalah sumber unik data sensor. Sumber data dapat mengekspos
data mentah yang berasal dari sensor hardware di perangkat lokal atau pendamping. Aplikasi
juga dapat mengekspos data turunan, yang dibuat dengan mengubah atau menggabungkan sumber data
lainnya. Beberapa sumber data bisa ada untuk jenis data yang sama. Setiap titik
data di setiap set data yang dimasukkan ke atau dibaca dari Fitness API memiliki
sumber data terkait.
Setiap sumber data menghasilkan aliran pembaruan set data yang unik, dengan
ID sumber data yang unik. Tidak semua perubahan pada sumber data memengaruhi
ID aliran data, sehingga data yang dikumpulkan oleh versi terbaru dari aplikasi/perangkat
yang sama masih dapat dianggap milik sumber data
yang sama.
Sumber data diidentifikasi menggunakan string yang dihasilkan oleh server, berdasarkan
konten sumber yang dibuat. Kolom dataStreamId
tidak boleh ditetapkan saat memanggil metode ini. Parameter ini akan otomatis dibuat oleh server dengan format yang benar. Jika ditetapkan, dataStreamId
harus cocok dengan format yang akan dihasilkan server. Format ini adalah kombinasi beberapa kolom dari
sumber data, dan memiliki urutan tertentu. Jika tidak cocok, permintaan akan gagal dengan pesan error.
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; sebagai gantinya, gunakan jenis data standar.
Selain kolom sumber data yang disertakan dalam ID sumber data, nomor project developer yang diautentikasi saat membuat sumber data juga disertakan. Nomor project developer ini di-obfuscate saat dibaca
oleh developer lain yang membaca jenis 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 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. | |
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:
|
|
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:
|
|
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:
|
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.