Liệt kê các phiên đã tạo trước đây. Thử ngay.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/sessions
Thông 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 sự kiện cho người đã xác định. 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 .
|
Tham số truy vấn không bắt buộc | ||
activityType |
integer |
Nếu giá trị 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 trong khoảng thời gian bắt đầu đến kết thúc mới được đưa vào phản hồi. Nếu bạn bỏ qua thời gian này nhưng startTime được chỉ định, thì tất cả các phiên từ startTime đến cuối thời gian sẽ được trả về. |
includeDeleted |
boolean |
Nếu đúng và nếu cả startTime và endTime đều bị bỏ qua, thì thao tác xoá phiên sẽ được trả về. |
pageToken |
string |
Mã thông báo tiếp tục, dùng để đồng bộ hoá gia tăng.
Để nhận đợt thay đổi tiếp theo, hãy đặt tham số này thành giá trị 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, thì 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 trong khoảng thời gian bắt đầu đến kết thúc mới được đưa vào phản hồi. Nếu bạn bỏ qua thời gian này nhưng bạn chỉ định endTime, thì tất cả các phiên hoạt động từ thời điểm bắt đầu đến endTime sẽ được trả về. |
Ủy quyền
Yêu cầu này cần được 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à uỷ quyền.
Nội dung yêu cầu
Khô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 có cấu trúc như 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ả | Ghi chú |
---|---|---|---|
session[] |
list |
Phiên hoạt động có thời gian kết thúc nằm trong khoảng từ startTime đến endTime so với yêu cầu. |
|
session[].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. | |
session[].name |
string |
Tên phiên (con người có thể đọc được). | |
session[].description |
string |
Nội dung 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 (bao gồm cả 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 (bao gồm cả 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 phiên được sửa đổi lần gần đây nhất. | |
session[].application |
nested object |
Ứng dụng đã tạo phiên. | |
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 đượ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. | |
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 không bắt buộc có thể được dùng để liên kết trở lại ứng dụng. | |
session[].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. | |
session[].activityType |
integer |
Loại hoạt động mà phiên này đại diện. | |
deletedSession[] |
list |
Nếu bạn đặt includeDeleted thành true trong yêu cầu, đồng thời startTime và endTime bị bỏ qua, thì số 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ộ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. | |
deletedSession[].name |
string |
Tên phiên (con người có thể đọc được). | |
deletedSession[].description |
string |
Nội dung 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 (bao gồm cả 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 (bao gồm cả 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 phiên được sửa đổi lần gần đây nhất. | |
deletedSession[].application |
nested object |
Ứng dụng đã tạo phiên. | |
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 đượ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. | |
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 không bắt buộc có thể được dùng để liên kết trở lại ứng dụng. | |
deletedSession[].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. | |
deletedSession[].activityType |
integer |
Loại hoạt động mà phiên này đại diện. | |
nextPageToken |
string |
Mã đồng bộ hoá dùng để đồng bộ hoá các thay đổi khác. Giá trị này sẽ chỉ được cung cấp nếu cả startTime và endTime đều bị bỏ qua trong yêu cầu. | |
session[].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 |
|
deletedSession[].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 |
|
hasMoreData |
boolean |
Gắn cờ để cho biết máy chủ có nhiều dữ liệu cần chuyển hơn. KHÔNG SỬ DỤNG TRƯỜNG NÀY. Dữ liệu này không bao giờ được điền sẵn vào phản hồi từ 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.