API Reference

Referensi API ini diatur menurut jenis resource. Setiap jenis resource memiliki satu atau beberapa representasi data dan satu atau beberapa metode.

Jenis resource

  1. Users.dataSources
  2. Users.dataSources.dataPointChanges
  3. Users.dataSources.datasets
  4. Users.dataset
  5. Users.sessions

Users.dataSources

Untuk detail Resource Pengguna.dataSources, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang bersifat relatif terhadap https://www.googleapis.com/fitness/v1/users, kecuali dinyatakan lain
buat POST  /userId/dataSources 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. Kolom dataStreamId 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 DELETE  /userId/dataSources/dataSourceId Menghapus sumber data yang ditentukan. Permintaan akan gagal jika sumber data berisi titik data apa pun.
dapatkan GET  /userId/dataSources/dataSourceId Menampilkan sumber data yang ditentukan.
list GET  /userId/dataSources Mencantumkan semua sumber data yang dapat dilihat 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 PUT  /userId/dataSources/dataSourceId Memperbarui sumber data yang ditentukan. Properti dataStreamId, dataType, type, dataStreamName, dan device dengan pengecualian version, tidak dapat diubah.

Sumber data diidentifikasi oleh dataStreamId.

Users.dataSources.dataPointChanges

Untuk detail Users.dataSources.dataPointChanges Resource, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang bersifat relatif terhadap https://www.googleapis.com/fitness/v1/users, kecuali dinyatakan lain
list GET  /userId/dataSources/dataSourceId/dataPointChanges Kueri untuk titik data pengguna berubah untuk sumber data tertentu.

Users.dataSources.datasets

Untuk detail Resource.UsersSources.datasets Resource, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang bersifat relatif terhadap https://www.googleapis.com/fitness/v1/users, kecuali dinyatakan lain
hapus DELETE  /userId/dataSources/dataSourceId/datasets/datasetId Melakukan penghapusan inklusif untuk semua titik data yang waktu mulai dan waktunya tumpang-tindih dengan rentang waktu yang ditentukan oleh ID set data. Untuk sebagian besar jenis data, seluruh titik data akan dihapus. Untuk jenis data dengan rentang waktu merepresentasikan nilai yang konsisten (seperti com.google.activity.segment), dan titik data berada di salah satu titik akhir set data, hanya bagian titik data yang tumpang-tindih yang akan dihapus.
dapatkan GET  /userId/dataSources/dataSourceId/datasets/datasetId Menampilkan set data yang berisi semua titik data yang waktu mulai dan waktunya tumpang-tindih dengan rentang waktu mulai minimum dan waktu berakhir maksimum yang ditentukan dari set data. Secara khusus, setiap titik data yang waktu mulainya kurang dari atau sama dengan waktu berakhir set data dan waktu akhirnya yang lebih besar atau sama dengan waktu mulai set data.
patch PATCH  /userId/dataSources/dataSourceId/datasets/datasetId Menambahkan titik data ke set data. Set data tidak perlu dibuat sebelumnya. Semua titik dalam set data tertentu akan ditampilkan dengan panggilan selanjutnya untuk mengambil set data ini. Titik data dapat dimiliki oleh lebih dari satu set data.

Metode ini tidak menggunakan semantik patch: titik data yang disediakan hanya disisipkan, tanpa data yang ada diganti.

Users.dataset

Untuk detail Resource pengguna.dataset, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang bersifat relatif terhadap https://www.googleapis.com/fitness/v1/users, kecuali dinyatakan lain
gabungkan POST  /userId/dataset:aggregate Menggabungkan data jenis atau aliran tertentu ke dalam bucket yang dibagi dengan jenis batas tertentu. Beberapa set data dengan beberapa jenis dan dari beberapa sumber dapat digabungkan ke dalam tepat satu jenis bucket per permintaan.

User.sessions

Untuk detail Resource Pengguna.sessions, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI yang bersifat relatif terhadap https://www.googleapis.com/fitness/v1/users, kecuali dinyatakan lain
hapus DELETE  /userId/sessions/sessionId Menghapus sesi yang ditentukan oleh ID sesi yang diberikan.
list GET  /userId/sessions Mencantumkan sesi yang dibuat sebelumnya.
perbarui PUT  /userId/sessions/sessionId Memperbarui atau menyisipkan sesi tertentu.