Cập nhật hoặc chèn một phiên cụ thể. Thử ngay.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/fitness/v1/users/userId/sessions/sessionId
Tham số
Tên thông số | Giá trị | 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 được xác định. Sử dụng me để cho biết
người dùng đã 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 có 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ị | Mô tả | Ghi chú |
---|---|---|---|
id |
string |
Giá trị nhận dạng do khách hàng tạo riêng biệt trên tất cả các phiên hoạt động do người dùng cụ thể này sở hữu. | |
name |
string |
Tên phiên dễ đọc. | |
description |
string |
Nội dung mô tả cho 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, tính toàn bộ. | |
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, tính toàn bộ. | |
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 dùng làm giá trị nhận dạng duy nhất khi do các ứng dụng Android tạo, nhưng ứng dụng REST không thể chỉ định được. Máy khách REST sẽ được phản ánh số dự án nhà phát triển của họ trong 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 hướng ả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 lại ứng dụng. | |
application.name |
string |
Tên của ứng dụng này. Điều này là bắt buộc đối với các ứ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. API 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 trong phiên này. | |
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 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 xác định được thời gian không hoạt động trong phiên, bạn cũng nên chèn thời gian đó qua một điểm dữ liệu com.google.activity.segment với giá trị hoạt động VẪN |
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ị | Mô tả | Ghi chú |
---|---|---|---|
id |
string |
Giá trị nhận dạng do khách hàng tạo riêng biệt trên tất cả các phiên hoạt động do người dùng cụ thể này sở hữu. | |
name |
string |
Tên phiên dễ đọc. | |
description |
string |
Nội dung mô tả cho 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, tính toàn bộ. | |
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, tính toàn bộ. | |
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 dùng làm giá trị nhận dạng duy nhất khi do các ứng dụng Android tạo, nhưng ứng dụng REST không thể chỉ định được. Máy khách REST sẽ được phản ánh số dự án nhà phát triển của họ trong 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 hướng ả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 lại ứng dụng. | |
application.name |
string |
Tên của ứng dụng này. Điều này là bắt buộc đối với các ứ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. API 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 trong phiên này. | |
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 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 xác định được thời gian không hoạt động trong phiên, bạn cũng nên chèn thời gian đó qua một điểm dữ liệu com.google.activity.segment với giá trị hoạt động VẪN |
Hãy dùng thử!
Hãy sử dụng APIs Explorer (Trình khám phá API) 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.