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

Thông số

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

Ủy quyền

Yêu cầu này cần được uỷ quyền với 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à uỷ quyền.

Nội dung yêu cầu

Trong nội dung yêu cầu, hãy cung cấp dữ liệu theo 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ả Ghi chú
id string Một giá trị nhận dạng duy nhất do ứng dụng tạo trên tất cả các phiên do người dùng cụ thể này sở hữu.
name string Tên phiên (con người có thể đọc được).
description string Nội dung 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 (bao gồm cả 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 (bao gồm cả 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 phiên được sửa đổi lần gần đây nhất.
application nested object Ứng dụng đã tạo phiên.
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 được các ứng dụng Android tạo, nhưng các ứng dụng REST không thể chỉ định giá trị này. Các ứng dụng REST sẽ được phản ánh số dự án dành cho nhà phát triển trong mã luồng dữ liệu của 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 không bắt buộc có thể được dùng để liên kết trở lại ứng dụng.
application.name string Tên của ứng dụng này. Đây là tên bắt buộc đối với các khách hàng REST, nhưng chúng tôi không áp dụng tên duy nhất cho tên này. Việc 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_millis và end_time_millis xác định thời gian của toàn bộ phiên, nhưng thời gian hoạt động có thể ngắn hơn và được chỉ định bằng activity_time_millis. Nếu đã biết thời gian không hoạt động trong phiên, bạn cũng phải chèn thời gian này thông qua một điểm dữ liệu com.google.activity.segment có giá trị hoạt động STILL

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 có cấu trúc như 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ả Ghi chú
id string Một giá trị nhận dạng duy nhất do ứng dụng tạo trên tất cả các phiên do người dùng cụ thể này sở hữu.
name string Tên phiên (con người có thể đọc được).
description string Nội dung 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 (bao gồm cả 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 (bao gồm cả 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 phiên được sửa đổi lần gần đây nhất.
application nested object Ứng dụng đã tạo phiên.
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 được các ứng dụng Android tạo, nhưng các ứng dụng REST không thể chỉ định giá trị này. Các ứng dụng REST sẽ được phản ánh số dự án dành cho nhà phát triển trong mã luồng dữ liệu của 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 không bắt buộc có thể được dùng để liên kết trở lại ứng dụng.
application.name string Tên của ứng dụng này. Đây là tên bắt buộc đối với các khách hàng REST, nhưng chúng tôi không áp dụng tên duy nhất cho tên này. Việc 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_millis và end_time_millis xác định thời gian của toàn bộ phiên, nhưng thời gian hoạt động có thể ngắn hơn và được chỉ định bằng activity_time_millis. Nếu đã biết thời gian không hoạt động trong phiên, bạn cũng phải chèn thời gian này thông qua một điểm dữ liệu com.google.activity.segment có giá trị hoạt động STILL

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.