Users.dataSources.dataPointChanges: list

Các truy vấn cho điểm dữ liệu của người dùng sẽ thay đổi đố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

Các tham số

Tên thông số Giá trị Nội dung 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 đã được xác thực. Hiện chỉ hỗ trợ me.
Tham số truy vấn tùy chọn
limit integer Nếu được chỉ định, không có quá nhiều thay đổi về điểm dữ liệu này sẽ được đưa vào nội dung phản hồi.
pageToken string Mã thông báo tiếp tục dùng để phân trang thông qua các tập hợp kết quả lớn. Để xem trang kết quả 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.

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

{
  "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ị Nội dung mô tả Lưu ý
insertedDataPoint[] list Đã chèn các đ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 một tập dữ liệu cho nguồn dữ liệu phái sinh, trường này sẽ được điền sẵn mã luồng 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 cho bất kỳ mục đích nào khác ngoài việc gỡ lỗi. Giá trị của trường này (nếu được đặt) là thông tin chi tiết về cách triển khai và không đảm bảo sẽ 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 đúng thứ tự mà trường đó được liệt kê trong loại dữ liệu quy định trong nguồn dữ liệu.

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

insertedDataPoint[].value[].intVal integer Giá trị 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. Chuỗi phải được giữ 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ị lấy mẫu.
insertedDataPoint[].value[].mapVal[] list Giá trị bản đồ. Bạn phải ghi lại không gian khóa và đơn vị hợp lệ cho giá trị tương ứng của mỗi mục trong định nghĩa loại dữ liệu. Bạn nên giữ chìa khóa nhỏ bất cứ khi nào có thể. Các luồng dữ liệu có khóa lớn và tần suất dữ liệu cao có thể bị lấy mẫu.
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 sửa đổi điểm dữ liệu gần đây nhất. Chỉ hữu ích trong các bối cảnh mà chúng tôi đang liệt kê các thay đổi về dữ liệu, thay vì thể hiện 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 KHÔNG SỬ DỤNG TRƯỜNG NÀY. Thuộc tính 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 ý: để sửa đổi, bạn nên phân tích cú pháp của nội dung này trước khi xử lý thao tá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 một tập dữ liệu cho nguồn dữ liệu phái sinh, trường này sẽ được điền sẵn mã luồng 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 cho bất kỳ mục đích nào khác ngoài việc gỡ lỗi. Giá trị của trường này (nếu được đặt) là thông tin chi tiết về cách triển khai và không đảm bảo sẽ 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 đúng thứ tự mà trường đó được liệt kê trong loại dữ liệu quy định trong nguồn dữ liệu.

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

deletedDataPoint[].value[].intVal integer Giá trị 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. Chuỗi phải được giữ 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ị lấy mẫu.
deletedDataPoint[].value[].mapVal[] list Giá trị bản đồ. Bạn phải ghi lại không gian khóa và đơn vị hợp lệ cho giá trị tương ứng của mỗi mục trong định nghĩa loại dữ liệu. Bạn nên giữ chìa khóa nhỏ bất cứ khi nào có thể. Các luồng dữ liệu có khóa lớn và tần suất dữ liệu cao có thể bị lấy mẫu.
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 sửa đổi điểm dữ liệu gần đây nhất. Chỉ hữu ích trong các bối cảnh mà chúng tôi đang liệt kê các thay đổi về dữ liệu, thay vì thể hiện 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 KHÔNG SỬ DỤNG TRƯỜNG NÀY. Thuộc tính này sẽ bị bỏ qua và không được lưu trữ.
nextPageToken string Mã thông báo tiếp tụ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ó thay đổi về điểm dữ liệu.

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.