Definisi sumber data sensor yang unik. Sumber data dapat mengekspos data mentah yang berasal dari sensor hardware pada perangkat lokal atau pendamping. Mereka juga dapat mengekspos data turunan, yang dibuat dengan mengubah atau menggabungkan sumber data lainnya. Terdapat beberapa sumber data untuk jenis data yang sama. Setiap titik data yang disisipkan ke atau membaca dari layanan ini memiliki sumber data terkait.
Sumber data berisi informasi yang cukup untuk mengidentifikasi datanya secara unik, termasuk perangkat hardware dan aplikasi yang mengumpulkan dan/atau mengubah data. File juga menyimpan metadata yang berguna, seperti versi hardware dan aplikasi, serta jenis perangkat.
Setiap sumber data menghasilkan aliran data yang unik, dengan ID unik. Tidak semua perubahan pada sumber data memengaruhi ID aliran data, sehingga data yang dikumpulkan oleh versi terbaru aplikasi/perangkat yang sama masih dapat dianggap sebagai bagian dari aliran data yang sama.
Untuk daftar metode bagi resource ini, lihat bagian akhir halaman ini.
Representasi resource
{ "dataStreamId": string, "name": string, "dataStreamName": string, "type": string, "dataType": { "name": string, "field": [ { "name": string, "format": string, "optional": boolean } ] }, "device": { "uid": string, "type": string, "version": string, "model": string, "manufacturer": string }, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "dataQualityStandard": [ string ] }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
application |
nested object |
Informasi tentang aplikasi yang memasukkan data sensor ke dalam platform. | |
application.detailsUrl |
string |
URI opsional yang dapat digunakan untuk menautkan kembali ke aplikasi. | |
application.name |
string |
Nama aplikasi ini. Ini diperlukan untuk klien REST, tetapi kami tidak menerapkan keunikan nama ini. Fungsi ini disediakan untuk memudahkan developer lain yang ingin mengidentifikasi REST mana yang membuat Aplikasi atau Sumber Data. | |
application.packageName |
string |
Nama paket untuk aplikasi ini. Ini digunakan sebagai ID unik saat dibuat oleh aplikasi Android, tetapi tidak dapat ditentukan oleh klien REST. Klien REST akan menampilkan nomor project developer-nya ke ID aliran data Sumber Data, bukan packageName. | |
application.version |
string |
Versi aplikasi. Anda harus memperbarui kolom ini setiap kali aplikasi berubah dengan cara yang memengaruhi komputasi data. | |
dataQualityStandard[] |
list |
JANGAN MELEWATKAN KOLOM INI. Ini tidak pernah diisi sebagai respons dari platform, dan diabaikan dalam kueri. Ini akan dihapus di versi mendatang sepenuhnya. | |
dataStreamId |
string |
ID unik untuk aliran data yang dihasilkan oleh sumber data ini. ID mencakup:
Format persis ID aliran data yang dibuat oleh aplikasi Android adalah: type:dataType.name Format persis ID aliran data yang dibuat oleh klien REST adalah: type:dataType.name Jika ada kolom opsional yang membentuk ID aliran data, kolom tersebut akan dihilangkan dari ID aliran data. ID aliran data minimum yang valid adalah: type:dataType.name:developer project number Terakhir, nomor project developer dan UID perangkat di-obfuscate saat dibaca oleh klien REST atau Android 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 yang berbeda. |
|
dataStreamName |
string |
Nama aliran secara unik mengidentifikasi sumber data tertentu ini di antara sumber data lain dari jenis yang sama dari produser pokok yang sama. Menyetel nama aliran data bersifat opsional, tetapi harus dilakukan setiap kali aplikasi mengekspos dua aliran data untuk jenis data yang sama, atau saat perangkat memiliki dua sensor yang setara. | |
dataType |
nested object |
Jenis data menentukan skema untuk aliran data yang dikumpulkan, disisipkan ke, atau dikueri dari Fitness API. | |
dataType.field[] |
list |
Kolom mewakili satu dimensi dari jenis data. | |
dataType.field[].format |
string |
Format yang didukung yang berbeda untuk setiap kolom dalam 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 perlu bersifat unik dalam jenis data. | |
dataType.field[].optional |
boolean |
||
dataType.name |
string |
Setiap jenis data memiliki nama unik yang 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 pengguna yang terlihat. | |
device.type |
string |
Konstanta yang mewakili jenis perangkat.
Nilai yang dapat diterima adalah:
|
|
device.uid |
string |
Nomor seri atau ID unik hardware lainnya. Kolom ini di-obfuscate saat dibaca oleh klien REST atau Android yang tidak membuat sumber data. Hanya kreator 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. | |
name |
string |
Nama pengguna akhir yang terlihat untuk sumber data ini. | |
type |
string |
Konstanta yang menjelaskan jenis sumber data ini. Menunjukkan apakah sumber data ini menghasilkan data mentah atau turunan.
Nilai yang dapat diterima adalah:
|
Metode
- buat
- Membuat sumber data baru yang unik di semua sumber data milik pengguna ini.
Sumber data adalah sumber data sensor unik. Sumber data dapat mengekspos data mentah yang berasal dari sensor hardware pada perangkat lokal atau pendamping. Resource ini juga dapat mengekspos data turunan, yang dibuat dengan mengubah atau menggabungkan sumber data lainnya. Terdapat beberapa sumber data 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 unik update set data, 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 berasal dari sumber data yang sama.
Sumber data diidentifikasi menggunakan string yang dihasilkan oleh server, berdasarkan konten sumber yang dibuat. KolomdataStreamId
tidak boleh ditetapkan saat memanggil metode ini. File tersebut akan otomatis dibuat oleh server dengan format yang benar. Jika ditetapkan,dataStreamId
harus cocok dengan format yang akan dihasilkan server. Format ini merupakan kombinasi beberapa kolom dari sumber data dan memiliki urutan tertentu. Jika tidak cocok, permintaan akan gagal dengan error.
Menentukan DataType yang bukan merupakan jenis yang diketahui (diawali 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 disertakan. Nomor project developer ini di-obfuscate saat dibaca oleh developer lain yang membaca jenis data publik. - hapus
- Menghapus sumber data yang ditentukan. Permintaan akan gagal jika sumber data berisi titik data apa pun.
- dapatkan
- Menampilkan sumber data yang ditentukan.
- list
- Mencantumkan semua sumber data yang terlihat oleh developer, menggunakan cakupan OAuth yang disediakan. Daftar ini tidak lengkap; pengguna mungkin memiliki sumber data pribadi yang hanya dapat dilihat oleh developer lain, atau panggilan menggunakan cakupan lain.
- perbarui
- Memperbarui sumber data yang ditentukan. Properti
dataStreamId
,dataType
,type
,dataStreamName
, dandevice
dengan pengecualianversion
, tidak dapat diubah.
Sumber data diidentifikasi olehdataStreamId
.