Users.sessions: update

Memperbarui atau menyisipkan sesi tertentu. Coba sekarang.

Permintaan

Permintaan HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
sessionId string ID sesi yang akan dibuat.
userId string Buat sesi untuk orang yang diidentifikasi. Gunakan me untuk menunjukkan pengguna yang diautentikasi. Hanya me yang didukung untuk saat ini.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

Cakupan
https://www.googleapis.com/auth/fitness.activity.write

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, sediakan data dengan struktur berikut:

{
  "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
}
Nama properti Nilai Deskripsi Catatan
id string ID yang dibuat klien yang unik di semua sesi yang dimiliki oleh pengguna tertentu ini.
name string Nama sesi yang dapat dibaca manusia.
description string Deskripsi untuk sesi ini.
startTimeMillis long Waktu mulai, dalam milidetik sejak epoch, inklusif.
endTimeMillis long Waktu berakhir, dalam milidetik sejak epoch, inklusif.
modifiedTimeMillis long Stempel waktu yang menunjukkan kapan sesi terakhir diubah.
application nested object Aplikasi yang membuat sesi.
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.
application.version string Versi aplikasi. Anda harus memperbarui kolom ini setiap kali aplikasi berubah dengan cara yang memengaruhi komputasi data.
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. Fungsi ini disediakan untuk memudahkan developer lain yang ingin mengidentifikasi REST mana yang membuat Aplikasi atau Sumber Data.
activityType integer Jenis aktivitas yang diwakili sesi ini.
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

Tanggapan

Jika berhasil, metode ini menampilkan isi respons dengan struktur berikut:

{
  "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
}
Nama properti Nilai Deskripsi Catatan
id string ID yang dibuat klien yang unik di semua sesi yang dimiliki oleh pengguna tertentu ini.
name string Nama sesi yang dapat dibaca manusia.
description string Deskripsi untuk sesi ini.
startTimeMillis long Waktu mulai, dalam milidetik sejak epoch, inklusif.
endTimeMillis long Waktu berakhir, dalam milidetik sejak epoch, inklusif.
modifiedTimeMillis long Stempel waktu yang menunjukkan kapan sesi terakhir diubah.
application nested object Aplikasi yang membuat sesi.
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.
application.version string Versi aplikasi. Anda harus memperbarui kolom ini setiap kali aplikasi berubah dengan cara yang memengaruhi komputasi data.
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. Fungsi ini disediakan untuk memudahkan developer lain yang ingin mengidentifikasi REST mana yang membuat Aplikasi atau Sumber Data.
activityType integer Jenis aktivitas yang diwakili sesi ini.
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

Cobalah!

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