Mencantumkan sesi yang dibuat sebelumnya. Coba sekarang.
Permintaan
Permintaan HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter jalur | ||
userId |
string |
Buat daftar sesi untuk orang yang diidentifikasi. Gunakan me untuk menunjukkan
pengguna yang diautentikasi. Hanya me yang didukung untuk saat ini.
|
Parameter kueri opsional | ||
activityType |
integer |
Jika tidak kosong, hanya sesi dengan jenis aktivitas ini yang harus ditampilkan. |
endTime |
string |
Stempel waktu RFC3339. Hanya sesi yang berakhir antara waktu mulai dan berakhir yang akan disertakan dalam respons. Jika waktu ini dihilangkan tetapi startTime ditentukan, semua sesi dari startTime hingga akhir waktu akan ditampilkan. |
includeDeleted |
boolean |
Jika benar, dan jika startTime dan endTime dihilangkan, penghapusan sesi akan ditampilkan. |
pageToken |
string |
Token lanjutan, yang digunakan untuk sinkronisasi inkremental.
Untuk mendapatkan batch perubahan berikutnya, tetapkan parameter ini ke nilai nextPageToken dari respons sebelumnya. Token halaman diabaikan jika waktu mulai atau waktu berakhir ditentukan. Jika tidak ada waktu mulai, waktu berakhir, dan token halaman ditentukan, sesi yang diubah dalam 30 hari terakhir akan ditampilkan.
|
startTime |
string |
Stempel waktu RFC3339. Hanya sesi yang berakhir antara waktu mulai dan berakhir yang akan disertakan dalam respons. Jika waktu ini dihilangkan tetapi endTime ditentukan, semua sesi dari awal waktu hingga endTime akan ditampilkan. |
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut:
Cakupan |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Jangan menyediakan isi permintaan dengan metode ini.
Tanggapan
Jika berhasil, metode ini menampilkan isi respons dengan struktur berikut:
{ "session": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "deletedSession": [ { "id": string, "name": string, "description": string, "startTimeMillis": long, "endTimeMillis": long, "modifiedTimeMillis": long, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "activityType": integer, "activeTimeMillis": long } ], "nextPageToken": string, "hasMoreData": boolean }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
session[] |
list |
Sesi dengan waktu berakhir antara startTime dan endTime permintaan. |
|
session[].id |
string |
ID yang dibuat klien yang unik di semua sesi yang dimiliki oleh pengguna tertentu ini. | |
session[].name |
string |
Nama sesi yang dapat dibaca manusia. | |
session[].description |
string |
Deskripsi untuk sesi ini. | |
session[].startTimeMillis |
long |
Waktu mulai, dalam milidetik sejak epoch, inklusif. | |
session[].endTimeMillis |
long |
Waktu berakhir, dalam milidetik sejak epoch, inklusif. | |
session[].modifiedTimeMillis |
long |
Stempel waktu yang menunjukkan kapan sesi terakhir diubah. | |
session[].application |
nested object |
Aplikasi yang membuat sesi. | |
session[].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. | |
session[].application.version |
string |
Versi aplikasi. Anda harus memperbarui kolom ini setiap kali aplikasi berubah dengan cara yang memengaruhi komputasi data. | |
session[].application.detailsUrl |
string |
URI opsional yang dapat digunakan untuk menautkan kembali ke aplikasi. | |
session[].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. | |
session[].activityType |
integer |
Jenis aktivitas yang diwakili sesi ini. | |
deletedSession[] |
list |
Jika includeDeleted disetel ke benar dalam permintaan, serta startTime dan endTime dihilangkan, ini akan menyertakan sesi yang dihapus sejak sinkronisasi terakhir. |
|
deletedSession[].id |
string |
ID yang dibuat klien yang unik di semua sesi yang dimiliki oleh pengguna tertentu ini. | |
deletedSession[].name |
string |
Nama sesi yang dapat dibaca manusia. | |
deletedSession[].description |
string |
Deskripsi untuk sesi ini. | |
deletedSession[].startTimeMillis |
long |
Waktu mulai, dalam milidetik sejak epoch, inklusif. | |
deletedSession[].endTimeMillis |
long |
Waktu berakhir, dalam milidetik sejak epoch, inklusif. | |
deletedSession[].modifiedTimeMillis |
long |
Stempel waktu yang menunjukkan kapan sesi terakhir diubah. | |
deletedSession[].application |
nested object |
Aplikasi yang membuat sesi. | |
deletedSession[].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. | |
deletedSession[].application.version |
string |
Versi aplikasi. Anda harus memperbarui kolom ini setiap kali aplikasi berubah dengan cara yang memengaruhi komputasi data. | |
deletedSession[].application.detailsUrl |
string |
URI opsional yang dapat digunakan untuk menautkan kembali ke aplikasi. | |
deletedSession[].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. | |
deletedSession[].activityType |
integer |
Jenis aktivitas yang diwakili sesi ini. | |
nextPageToken |
string |
Token sinkronisasi yang digunakan untuk menyinkronkan perubahan lebih lanjut. Ini hanya akan diberikan jika startTime dan endTime dihilangkan dari permintaan. | |
session[].activeTimeMillis |
long |
Waktu aktif sesi. Meskipun start_time_milis dan end_time_millis menentukan waktu sesi penuh, waktu aktif dapat menjadi lebih singkat dan ditentukan oleh active_time_millis. Jika waktu tidak aktif selama sesi diketahui, waktu tersebut juga harus dimasukkan melalui titik data com.google.activity.segment dengan nilai aktivitas MASIH |
|
deletedSession[].activeTimeMillis |
long |
Waktu aktif sesi. Meskipun start_time_milis dan end_time_millis menentukan waktu sesi penuh, waktu aktif dapat menjadi lebih singkat dan ditentukan oleh active_time_millis. Jika waktu tidak aktif selama sesi diketahui, waktu tersebut juga harus dimasukkan melalui titik data com.google.activity.segment dengan nilai aktivitas MASIH |
|
hasMoreData |
boolean |
Tanda untuk menunjukkan bahwa server memiliki lebih banyak data untuk ditransfer. JANGAN GUNAKAN KOLOM INI. Fitur ini tidak pernah diisi sebagai respons dari server. |
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat responsnya.