Users.sessions: update

Cập nhật hoặc chèn một phiên nhất định. Thử ngay.

Yêu cầu

Yêu cầu HTTP

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

Các tham số

Tên thông số Giá trị Nội dung mô tả
Tham số đường dẫn
sessionId string Mã phiên.
userId string Tạo phiên cho người được xác định. Sử dụng me để cho biết người dùng đã được xác thực. Hiện chỉ hỗ trợ me.

Ủy quyền

Yêu cầu này cần được cho phép trong phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/fitness.activity.write

Để biết thêm thông tin, hãy xem trang xác thực và ủy quyền.

Nội dung yêu cầu

Trong phần nội dung yêu cầu, hãy cung cấp dữ liệu có cấu trúc sau:

{
  "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
}
Tên tài sản Giá trị Nội dung mô tả Lưu ý
id string Mã nhận dạng do khách hàng tạo sẽ là duy nhất trong tất cả các phiên hoạt động thuộc sở hữu của người dùng cụ thể này.
name string Tên có thể đọc được của phiên.
description string Mô tả về phiên này.
startTimeMillis long Thời gian bắt đầu, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.
endTimeMillis long Thời gian kết thúc, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.
modifiedTimeMillis long Dấu thời gian cho biết thời điểm sửa đổi gần nhất của phiên.
application nested object Ứng dụng đã tạo ra phiên hoạt động.
application.packageName string Tên gói cho ứng dụng này. Giá trị này được dùng làm giá trị nhận dạng duy nhất khi tạo bởi các ứng dụng Android, nhưng không thể được chỉ định bởi các ứng dụng REST. Khách hàng REST sẽ có số dự án dành cho nhà phát triển của họ được phản ánh thành mã luồng dữ liệu Nguồn dữ liệu, thay vì packageName.
application.version string Phiên bản của ứng dụng. Bạn nên cập nhật trường này bất cứ khi nào ứng dụng thay đổi theo cách ảnh hưởng đến việc tính toán dữ liệu.
application.detailsUrl string URI tuỳ chọn có thể dùng để liên kết ngược trở lại ứng dụng.
application.name string Tên của ứng dụng này. Đây là yêu cầu bắt buộc đối với ứng dụng REST, nhưng chúng tôi không thực thi tính duy nhất của tên này. Điều này được cung cấp để thuận tiện cho các nhà phát triển khác muốn xác định REST nào đã tạo Ứng dụng hoặc Nguồn dữ liệu.
activityType integer Loại hoạt động mà phiên này đại diện.
activeTimeMillis long Thời gian hoạt động của phiên. Mặc dù start_time_mili giây và end_time_mili giây xác định toàn bộ thời gian của phiên, nhưng thời gian hoạt động có thể ngắn hơn và được chỉ định bằng Active_time_mili giây. Nếu xác định được thời gian không hoạt động trong phiên, thì bạn cũng nên chèn thời gian không hoạt động đó qua một điểm dữ liệu com.google.activity.Segment có giá trị hoạt động STILL của

Phản hồi

Nếu thành công, phương thức này sẽ trả về nội dung phản hồi với cấu trúc sau:

{
  "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
}
Tên tài sản Giá trị Nội dung mô tả Lưu ý
id string Mã nhận dạng do khách hàng tạo sẽ là duy nhất trong tất cả các phiên hoạt động thuộc sở hữu của người dùng cụ thể này.
name string Tên có thể đọc được của phiên.
description string Mô tả về phiên này.
startTimeMillis long Thời gian bắt đầu, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.
endTimeMillis long Thời gian kết thúc, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.
modifiedTimeMillis long Dấu thời gian cho biết thời điểm sửa đổi gần nhất của phiên.
application nested object Ứng dụng đã tạo ra phiên hoạt động.
application.packageName string Tên gói cho ứng dụng này. Giá trị này được dùng làm giá trị nhận dạng duy nhất khi tạo bởi các ứng dụng Android, nhưng không thể được chỉ định bởi các ứng dụng REST. Khách hàng REST sẽ có số dự án dành cho nhà phát triển của họ được phản ánh thành mã luồng dữ liệu Nguồn dữ liệu, thay vì packageName.
application.version string Phiên bản của ứng dụng. Bạn nên cập nhật trường này bất cứ khi nào ứng dụng thay đổi theo cách ảnh hưởng đến việc tính toán dữ liệu.
application.detailsUrl string URI tuỳ chọn có thể dùng để liên kết ngược trở lại ứng dụng.
application.name string Tên của ứng dụng này. Đây là yêu cầu bắt buộc đối với ứng dụng REST, nhưng chúng tôi không thực thi tính duy nhất của tên này. Điều này được cung cấp để thuận tiện cho các nhà phát triển khác muốn xác định REST nào đã tạo Ứng dụng hoặc Nguồn dữ liệu.
activityType integer Loại hoạt động mà phiên này đại diện.
activeTimeMillis long Thời gian hoạt động của phiên. Mặc dù start_time_mili giây và end_time_mili giây xác định toàn bộ thời gian của phiên, nhưng thời gian hoạt động có thể ngắn hơn và được chỉ định bằng Active_time_mili giây. Nếu xác định được thời gian không hoạt động trong phiên, thì bạn cũng nên chèn thời gian không hoạt động đó qua một điểm dữ liệu com.google.activity.Segment có giá trị hoạt động STILL của

Hãy dùng thử!

Sử dụng APIs Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.