Liệt kê các phiên được tạo trước đó. Thử ngay.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Các tham số
Tên thông số | Giá trị | Nội dung mô tả |
---|---|---|
Tham số đường dẫn | ||
userId |
string |
Liệt kê các 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 .
|
Tham số truy vấn tùy chọn | ||
activityType |
integer |
Nếu không để trống, chỉ những phiên có các loại hoạt động này mới được trả về. |
endTime |
string |
Dấu thời gian RFC3339. Chỉ những phiên kết thúc giữa thời gian bắt đầu và kết thúc mới được đưa vào phản hồi. Nếu thời gian này bị bỏ qua nhưng startTime được chỉ định, tất cả các phiên từ startTime đến cuối thời gian sẽ được trả về. |
includeDeleted |
boolean |
Nếu giá trị là true và nếu cả startTime và endTime đều bị bỏ qua, thì phiên sẽ bị xoá. |
pageToken |
string |
Mã thông báo tiếp tục (dùng để đồng bộ hoá gia tăng).
Để nhận lô thay đổi tiếp theo, hãy đặt thông số này thành giá trị của nextPageToken từ phản hồi trước. Mã thông báo trang sẽ bị bỏ qua nếu bạn chỉ định thời gian bắt đầu hoặc kết thúc. Nếu không có thời gian bắt đầu, thời gian kết thúc và mã thông báo trang được chỉ định, các phiên được sửa đổi trong 30 ngày qua sẽ được trả về.
|
startTime |
string |
Dấu thời gian RFC3339. Chỉ những phiên kết thúc giữa thời gian bắt đầu và kết thúc mới được đưa vào phản hồi. Nếu thời gian này bị bỏ qua nhưng endTime được chỉ định, thì tất cả các phiên từ thời điểm bắt đầu cho đến endTime sẽ được trả về. |
Ủy quyền
Yêu cầu này yêu cầu uỷ quyền với ít nhất một trong các phạm vi sau:
Phạm vi |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.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
Đừng cung cấp nội dung yêu cầu bằng phương thức này.
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:
{ "session": [ { "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 } ], "deletedSession": [ { "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 } ], "nextPageToken": string, "hasMoreData": boolean }
Tên tài sản | Giá trị | Nội dung mô tả | Lưu ý |
---|---|---|---|
session[] |
list |
Phiên có thời gian kết thúc từ startTime đến endTime của yêu cầu. |
|
session[].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. | |
session[].name |
string |
Tên có thể đọc được của phiên. | |
session[].description |
string |
Mô tả về phiên này. | |
session[].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. | |
session[].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. | |
session[].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. | |
session[].application |
nested object |
Ứng dụng đã tạo ra phiên hoạt động. | |
session[].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. | |
session[].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. | |
session[].application.detailsUrl |
string |
URI tuỳ chọn có thể dùng để liên kết ngược trở lại ứng dụng. | |
session[].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. | |
session[].activityType |
integer |
Loại hoạt động mà phiên này đại diện. | |
deletedSession[] |
list |
Nếu includeDeleted được đặt thành true trong yêu cầu, và startTime và endTime bị bỏ qua, thì dữ liệu này sẽ bao gồm các phiên bị xoá kể từ lần đồng bộ hoá gần nhất. |
|
deletedSession[].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. | |
deletedSession[].name |
string |
Tên có thể đọc được của phiên. | |
deletedSession[].description |
string |
Mô tả về phiên này. | |
deletedSession[].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. | |
deletedSession[].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. | |
deletedSession[].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. | |
deletedSession[].application |
nested object |
Ứng dụng đã tạo ra phiên hoạt động. | |
deletedSession[].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. | |
deletedSession[].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. | |
deletedSession[].application.detailsUrl |
string |
URI tuỳ chọn có thể dùng để liên kết ngược trở lại ứng dụng. | |
deletedSession[].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. | |
deletedSession[].activityType |
integer |
Loại hoạt động mà phiên này đại diện. | |
nextPageToken |
string |
Mã thông báo đồng bộ hoá sẽ dùng để đồng bộ hoá thêm các thay đổi. URL này chỉ được cung cấp nếu cả startTime và endTime đều bị bỏ qua khỏi yêu cầu. | |
session[].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 |
|
deletedSession[].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 |
|
hasMoreData |
boolean |
Gắn cờ để cho biết máy chủ có nhiều dữ liệu hơn để chuyển. KHÔNG SỬ DỤNG TRƯỜNG NÀY. Thông tin này không bao giờ được điền sẵn trong phản hồi của máy chủ. |
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.