Users.dataSources.dataPointChanges: list

Truy vấn về các thay đổi về điểm dữ liệu của người dùng đối với một nguồn dữ liệu cụ thể. Thử ngay.

Yêu cầu

Yêu cầu HTTP

GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges

Tham số

Tên thông số Giá trị Mô tả
Tham số đường dẫn
dataSourceId string Mã luồng dữ liệu của nguồn dữ liệu đã tạo tập dữ liệu.
userId string Liệt kê các điểm dữ liệu 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
limit integer Nếu được chỉ định, sẽ không có nhiều hơn số thay đổi về điểm dữ liệu này trong câu trả lời.
pageToken string Mã thông báo tiếp tục được dùng để phân trang thông qua các tập hợp kết quả lớn. Để nhận trang kết quả 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.

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

{
  "insertedDataPoint": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "deletedDataPoint": [
    {
      "startTimeNanos": long,
      "endTimeNanos": long,
      "dataTypeName": string,
      "originDataSourceId": string,
      "value": [
        {
          "intVal": integer,
          "fpVal": double,
          "stringVal": string,
          "mapVal": [
            {
              "key": string,
              "value": {
                "fpVal": double
              }
            }
          ]
        }
      ],
      "modifiedTimeMillis": long,
      "rawTimestampNanos": long,
      "computationTimeMillis": long
    }
  ],
  "nextPageToken": string,
  "dataSourceId": string
}
Tên tài sản Giá trị Mô tả Ghi chú
insertedDataPoint[] list Đã chèn điểm dữ liệu cho người dùng.
insertedDataPoint[].startTimeNanos long Thời gian bắt đầu của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống.
insertedDataPoint[].endTimeNanos long Thời gian kết thúc của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống.
insertedDataPoint[].dataTypeName string Loại dữ liệu xác định định dạng của các giá trị trong điểm dữ liệu này.
insertedDataPoint[].originDataSourceId string Nếu điểm dữ liệu nằm trong tập dữ liệu cho một nguồn dữ liệu phái sinh, thì trường này sẽ được điền sẵn mã luồng của nguồn dữ liệu đã tạo điểm dữ liệu ban đầu.

CẢNH BÁO: đừng dựa vào trường này để tìm bất cứ thông tin nào khác ngoài tính năng gỡ lỗi. Giá trị của trường này, nếu có, là chi tiết triển khai và không được đảm bảo để duy trì nhất quán.
insertedDataPoint[].value[] list Giá trị của mỗi trường loại dữ liệu cho điểm dữ liệu. Theo dự kiến, mỗi giá trị tương ứng với một trường loại dữ liệu sẽ xuất hiện theo cùng thứ tự mà trường được liệt kê trong loại dữ liệu được chỉ định trong nguồn dữ liệu.

Chỉ một trong các trường số nguyên và dấu phẩy động sẽ được điền sẵn, tuỳ thuộc vào giá trị enum của định dạng trong trường loại của nguồn dữ liệu.

insertedDataPoint[].value[].intVal integer Giá trị số nguyên. Khi đặt giá trị này, bạn không được đặt các giá trị khác.
insertedDataPoint[].value[].fpVal double Giá trị dấu phẩy động. Khi đặt giá trị này, bạn không được đặt các giá trị khác.
insertedDataPoint[].value[].stringVal string Giá trị chuỗi. Khi đặt giá trị này, bạn không được đặt các giá trị khác. Bạn nên giữ kích thước chuỗi nhỏ bất cứ khi nào có thể. Những luồng dữ liệu có giá trị chuỗi lớn và tần suất dữ liệu cao có thể bị giảm tần suất lấy mẫu.
insertedDataPoint[].value[].mapVal[] list Giá trị bản đồ. Không gian khoá và đơn vị khoá hợp lệ cho giá trị tương ứng của mỗi mục nhập phải được ghi lại trong quá trình định nghĩa kiểu dữ liệu. Bạn nên giữ các khoá nhỏ bất cứ khi nào có thể. Việc lấy mẫu những luồng dữ liệu có kích thước lớn và tần suất dữ liệu cao có thể được giảm xuống.
insertedDataPoint[].value[].mapVal[].key string
insertedDataPoint[].value[].mapVal[].value nested object
insertedDataPoint[].value[].mapVal[].value.fpVal double Giá trị dấu phẩy động.
insertedDataPoint[].modifiedTimeMillis long Cho biết lần gần nhất điểm dữ liệu này được sửa đổi. Chỉ hữu ích trong những ngữ cảnh mà chúng ta liệt kê các thay đổi về dữ liệu thay vì biểu thị trạng thái hiện tại của dữ liệu.
insertedDataPoint[].rawTimestampNanos long Dấu thời gian thô từ SensorEvent ban đầu.
insertedDataPoint[].computationTimeMillis long ĐỪNG SỬ DỤNG TRƯỜNG NÀY. Thông tin này sẽ bị bỏ qua và không được lưu trữ.
deletedDataPoint[] list Đã xoá các điểm dữ liệu cho người dùng. Lưu ý: đối với các nội dung sửa đổi, bạn cần phân tích cú pháp thông tin này trước khi xử lý việc chèn.
deletedDataPoint[].startTimeNanos long Thời gian bắt đầu của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống.
deletedDataPoint[].endTimeNanos long Thời gian kết thúc của khoảng thời gian được biểu thị bằng điểm dữ liệu này, tính bằng nano giây kể từ thời gian bắt đầu của hệ thống.
deletedDataPoint[].dataTypeName string Loại dữ liệu xác định định dạng của các giá trị trong điểm dữ liệu này.
deletedDataPoint[].originDataSourceId string Nếu điểm dữ liệu nằm trong tập dữ liệu cho một nguồn dữ liệu phái sinh, thì trường này sẽ được điền sẵn mã luồng của nguồn dữ liệu đã tạo điểm dữ liệu ban đầu.

CẢNH BÁO: đừng dựa vào trường này để tìm bất cứ thông tin nào khác ngoài tính năng gỡ lỗi. Giá trị của trường này, nếu có, là chi tiết triển khai và không được đảm bảo để duy trì nhất quán.
deletedDataPoint[].value[] list Giá trị của mỗi trường loại dữ liệu cho điểm dữ liệu. Theo dự kiến, mỗi giá trị tương ứng với một trường loại dữ liệu sẽ xuất hiện theo cùng thứ tự mà trường được liệt kê trong loại dữ liệu được chỉ định trong nguồn dữ liệu.

Chỉ một trong các trường số nguyên và dấu phẩy động sẽ được điền sẵn, tuỳ thuộc vào giá trị enum của định dạng trong trường loại của nguồn dữ liệu.

deletedDataPoint[].value[].intVal integer Giá trị số nguyên. Khi đặt giá trị này, bạn không được đặt các giá trị khác.
deletedDataPoint[].value[].fpVal double Giá trị dấu phẩy động. Khi đặt giá trị này, bạn không được đặt các giá trị khác.
deletedDataPoint[].value[].stringVal string Giá trị chuỗi. Khi đặt giá trị này, bạn không được đặt các giá trị khác. Bạn nên giữ kích thước chuỗi nhỏ bất cứ khi nào có thể. Những luồng dữ liệu có giá trị chuỗi lớn và tần suất dữ liệu cao có thể bị giảm tần suất lấy mẫu.
deletedDataPoint[].value[].mapVal[] list Giá trị bản đồ. Không gian khoá và đơn vị khoá hợp lệ cho giá trị tương ứng của mỗi mục nhập phải được ghi lại trong quá trình định nghĩa kiểu dữ liệu. Bạn nên giữ các khoá nhỏ bất cứ khi nào có thể. Việc lấy mẫu những luồng dữ liệu có kích thước lớn và tần suất dữ liệu cao có thể được giảm xuống.
deletedDataPoint[].value[].mapVal[].key string
deletedDataPoint[].value[].mapVal[].value nested object
deletedDataPoint[].value[].mapVal[].value.fpVal double Giá trị dấu phẩy động.
deletedDataPoint[].modifiedTimeMillis long Cho biết lần gần nhất điểm dữ liệu này được sửa đổi. Chỉ hữu ích trong những ngữ cảnh mà chúng ta liệt kê các thay đổi về dữ liệu thay vì biểu thị trạng thái hiện tại của dữ liệu.
deletedDataPoint[].rawTimestampNanos long Dấu thời gian thô từ SensorEvent ban đầu.
deletedDataPoint[].computationTimeMillis long ĐỪNG SỬ DỤNG TRƯỜNG NÀY. Thông tin này sẽ bị bỏ qua và không được lưu trữ.
nextPageToken string Mã thông báo tiếp tục được dùng để phân trang thông qua các tập hợp kết quả lớn. Hãy cung cấp giá trị này trong yêu cầu tiếp theo để trả về trang kết quả tiếp theo.
dataSourceId string Mã luồng dữ liệu của nguồn dữ liệu có điểm dữ liệu thay đổi.

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.