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.