Google Fit API, termasuk Google Fit REST API, tidak akan tersedia lagi setelah 30 Juni 2025. Mulai 1 Mei 2024, developer tidak dapat mendaftar untuk menggunakan API ini.

Untuk mendapatkan petunjuk terkait API atau platform yang menjadi tujuan migrasi, buka panduan migrasi Health Connect. Untuk perbandingan Health Connect dengan Google Fit API dan Fitbit Web API, buka panduan perbandingan Health Connect.

Pelajari lebih lanjut Health Connect dan cara berintegrasi dengan API.

Halaman ini diterjemahkan oleh Cloud Translation API.

Users.dataSources

Definisi sumber unik data sensor. Sumber data dapat mengekspos data mentah yang berasal dari sensor hardware di perangkat lokal atau pendamping. Sumber data ini juga dapat mengekspos data turunan, yang dibuat dengan mengubah atau menggabungkan sumber data lainnya. Beberapa sumber data dapat tersedia untuk jenis data yang sama. Setiap titik data yang disisipkan ke atau dibaca dari layanan ini memiliki sumber data terkait.

Sumber data berisi cukup informasi untuk mengidentifikasi datanya secara unik, termasuk perangkat hardware dan aplikasi yang mengumpulkan dan/atau mengubah data. File ini juga menyimpan metadata yang berguna, seperti versi hardware dan aplikasi, serta jenis perangkat.

Setiap sumber data menghasilkan aliran data 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 tetap dapat dianggap sebagai milik aliran data yang sama.

Untuk daftar metode untuk 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
`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. ID 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. ID ini digunakan sebagai ID unik saat dibuat oleh aplikasi Android, tetapi tidak dapat ditentukan oleh klien REST. Klien REST akan memiliki nomor project developer yang direfleksikan ke dalam ID aliran data Sumber Data, bukan packageName.
`application.version`	`string`	Versi aplikasi. Anda harus mengupdate kolom ini setiap kali aplikasi berubah dengan cara yang memengaruhi komputasi data.
`dataQualityStandard[]`	`list`	JANGAN POPULASI KOLOM INI. Kolom ini tidak pernah diisi dalam respons dari platform, dan diabaikan dalam kueri. Kebijakan ini akan dihapus sepenuhnya di versi mendatang.
`dataStreamId`	`string`	ID unik untuk aliran data yang dihasilkan oleh sumber data ini. ID ini mencakup: Produsen, model, dan nomor seri (UID) perangkat fisik. Nama atau nama paket aplikasi. Nama paket digunakan saat sumber data dibuat oleh aplikasi Android. Nomor project developer digunakan saat sumber data dibuat oleh klien REST. Jenis sumber data. Nama aliran data sumber data. Perlu diperhatikan bahwa tidak semua atribut sumber data digunakan sebagai bagian dari ID aliran data. Khususnya, versi hardware/aplikasi tidak digunakan. Hal ini memungkinkan kita mempertahankan aliran yang sama melalui update versi. Hal ini juga berarti bahwa dua objek DataSource dapat mewakili aliran data yang sama meskipun tidak sama. Format persis dari ID aliran data yang dibuat oleh aplikasi Android adalah: `type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName` Format persis ID aliran data yang dibuat oleh klien REST adalah: `type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName` Jika salah satu kolom opsional yang membentuk ID aliran data tidak ada, kolom tersebut akan dihilangkan dari ID aliran data. ID aliran data minimum yang valid adalah: type:dataType.name:nomor project developer Terakhir, nomor project developer dan UID perangkat di-obfuscate saat dibaca oleh klien Android atau REST 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 berbeda.
`dataStreamName`	`string`	Nama aliran data secara unik mengidentifikasi sumber data khusus ini di antara sumber data lain dari jenis yang sama dari produsen dasar yang sama. Menetapkan nama aliran data bersifat opsional, tetapi harus dilakukan setiap kali aplikasi menampilkan 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, 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.field[].optional`	`boolean`
`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.
`name`	`string`	Nama yang terlihat oleh pengguna akhir 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: "`derived`" "`raw`"

Metode

buat: 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.
hapus: Menghapus sumber data yang ditentukan. Permintaan akan gagal jika data berisi data titik.
dapatkan: Menampilkan sumber data yang ditentukan.
list: Mencantumkan semua sumber data yang dapat dilihat oleh developer, menggunakan OAuth cakupan yang disediakan. Daftar ini tidak lengkap; pengguna mungkin memiliki sumber data yang hanya dapat dilihat oleh developer lain, atau panggilan menggunakan cakupan lainnya.
info terbaru: Memperbarui sumber data yang ditentukan. dataStreamId, dataType, type, dataStreamName, dan Properti device dengan pengecualian version, tidak dapat diubah.

Sumber data diidentifikasi berdasarkan dataStreamId.