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.