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

Tham số

Tên thông số Giá trị 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 đã xác thực. Hiện 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ỉ các 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 từ thời gian bắt đầu đến thời gian kết thúc mới được đưa vào nội dung phản hồi. Nếu thời gian này bị bỏ qua nhưng startTime là đã chỉ định, tất cả các phiên từ startTime đến cuối thời gian sẽ bị trả lại.
includeDeleted boolean Nếu đúng và nếu cả startTime và endTime đều là 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 lô thay đổi tiếp theo, hãy đặt thông số này thành giá trị của nextPageToken của câu trả lời trước. Mã thông báo của trang là 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 được trả lại.
startTime string Dấu thời gian RFC3339. Chỉ những phiên kết thúc trong khoảng thời gian từ thời gian bắt đầu đến thời gian kết thúc mới được đưa vào nội dung phản hồi. Nếu thời gian này bị bỏ qua nhưng bạn đã chỉ định endTime, tất cả các phiên từ khi bắt đầu cho đến endTime sẽ được bị trả lại.

Ủy quyền

Yêu cầu này cần có sự 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

Đừ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ị Mô tả Ghi chú
session[] list Các phiên có thời gian kết thúc nằm trong khoảng từ startTime đến endTime của yêu cầu.

session[].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.
session[].name string Tên phiên dễ đọc.
session[].description string Nội dung mô tả cho 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, tính toàn bộ.
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 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.
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 hướng ả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 lại ứng dụng.
session[].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.
session[].activityType integer Loại hoạt động trong phiên này.
deletedSession[] list Nếu bạn đặt includeDeleted thành true trong yêu cầu và bỏ qua startTime và endTime, thì dữ liệu này sẽ bao gồm cả các phiên đã bị xoá kể từ lần đồng bộ hoá gần nhất.
deletedSession[].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.
deletedSession[].name string Tên phiên dễ đọc.
deletedSession[].description string Nội dung mô tả cho 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, tính toàn bộ.
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 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.
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 hướng ả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 lại ứng dụng.
deletedSession[].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.
deletedSession[].activityType integer Loại hoạt động trong phiên này.
nextPageToken string Mã thông báo đồng bộ hoá được dùng để đồng bộ hoá các thay đổi tiếp theo. Thông tin này 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 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

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 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

hasMoreData boolean Gắn cờ để cho biết máy chủ có nhiều dữ liệu cần chuyển hơn. ĐỪNG SỬ DỤNG TRƯỜNG NÀY. Trường này không bao giờ được điền vào phản hồi từ máy chủ.

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.