API Reference

Referensi API ini disusun berdasarkan 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 Users.dataSources, lihat halaman representasi resource.

Metode Permintaan HTTP Deskripsi
URI terkait dengan https://www.googleapis.com/fitness/v1/users, kecuali jika dinyatakan lain
buat POST  /userId/dataSources 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.
hapus DELETE  /userId/dataSources/dataSourceId Menghapus sumber data yang ditentukan. Permintaan akan gagal jika sumber data berisi titik data.
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 berdasarkan dataStreamId-nya.

Users.dataSources.dataPointChanges

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

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

Users.dataSources.datasets

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

Metode Permintaan HTTP Deskripsi
URI terkait dengan https://www.googleapis.com/fitness/v1/users, kecuali jika dinyatakan lain
hapus DELETE  /userId/dataSources/dataSourceId/datasets/datasetId Melakukan penghapusan inklusif untuk semua titik data yang waktu mulai dan waktunya bertumpang-tindih dengan rentang waktu yang ditentukan oleh ID set data. Untuk sebagian besar jenis data, seluruh titik data akan dihapus. Untuk jenis data yang rentang waktunya mewakili nilai yang konsisten (seperti com.google.activity.segment), dan sebuah titik data membagi salah satu titik akhir set data, hanya bagian tumpang-tindih dari titik data yang akan dihapus.
dapatkan GET  /userId/dataSources/dataSourceId/datasets/datasetId Menampilkan set data yang berisi semua titik data yang waktu mulai dan waktu berakhirnya tumpang-tindih dengan rentang waktu mulai minimum dan waktu berakhir maksimum set data yang ditentukan. Khususnya, setiap titik data yang waktu mulainya lebih kecil dari atau sama dengan waktu berakhir set data, dan yang waktu berakhirnya 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 yang diberikan akan ditampilkan dengan panggilan berikutnya untuk mengambil set data ini. Titik data dapat dimiliki oleh lebih dari satu {i>dataset<i}.

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

Users.dataset

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

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

Users.sessions

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

Metode Permintaan HTTP Deskripsi
URI terkait dengan https://www.googleapis.com/fitness/v1/users, kecuali jika 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.