Users.sessions: list

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 terautentikasi. Saat ini hanya me yang didukung.
Parameter kueri opsional
activityType integer Jika tidak kosong, hanya sesi dengan jenis aktivitas ini yang akan ditampilkan.
endTime string Stempel waktu RFC3339. Hanya sesi yang berakhir di antara waktu mulai dan berakhir yang akan disertakan dalam responsnya. Jika waktu ini dihilangkan tetapi startTime dihapus semua sesi dari startTime hingga akhir waktu akan dikembalikan.
includeDeleted boolean Jika benar, dan jika startTime dan endTime sama dihilangkan, penghapusan sesi akan dikembalikan.
pageToken string Token kelanjutan, yang digunakan untuk sinkronisasi inkremental. Untuk mendapatkan kumpulan perubahan berikutnya, tetapkan parameter ini ke nilai nextPageToken dari respons sebelumnya. Token halaman adalah diabaikan jika waktu mulai atau waktu berakhir telah ditentukan. Jika tidak ada waktu mulai, waktu berakhir, dan token halaman ditentukan, sesi diubah dalam 30 hari akan dikembalikan.
startTime string Stempel waktu RFC3339. Hanya sesi yang berakhir di antara waktu mulai dan berakhir yang akan disertakan dalam responsnya. Jika waktu ini dihilangkan tetapi endTime ditentukan, semua sesi dari awal waktu hingga endTime akan dikembalikan.

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 berikan isi permintaan dengan metode ini.

Respons

Jika berhasil, metode ini akan 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 di antara startTime dan endTime dari permintaan.

session[].id string ID buatan 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 waktu sesi terakhir diubah.
session[].application nested object Aplikasi yang membuat sesi.
session[].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.
session[].application.version string Versi aplikasi. Anda harus mengupdate 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. ID 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 ditetapkan ke benar (true) dalam permintaan, dan startTime serta endTime dihapus, sesi ini akan menyertakan sesi yang dihapus sejak sinkronisasi terakhir.
deletedSession[].id string ID buatan 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 waktu sesi terakhir diubah.
deletedSession[].application nested object Aplikasi yang membuat sesi.
deletedSession[].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.
deletedSession[].application.version string Versi aplikasi. Anda harus mengupdate 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. ID 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. Kolom ini hanya akan diberikan jika startTime dan endTime dihapus dari permintaan.
session[].activeTimeMillis long Waktu aktif sesi. Meskipun start_time_millis dan end_time_millis menentukan waktu sesi penuh, waktu aktif dapat 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 STILL

deletedSession[].activeTimeMillis long Waktu aktif sesi. Meskipun start_time_millis dan end_time_millis menentukan waktu sesi penuh, waktu aktif dapat 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 STILL

hasMoreData boolean Tanda untuk menunjukkan bahwa server memiliki lebih banyak data yang akan ditransfer. JANGAN GUNAKAN KOLOM INI. Kolom ini tidak pernah diisi dalam respons dari server.

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.