Users.sessions: list

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.