Thêm điểm dữ liệu vào tập dữ liệu. Bạn không cần phải tạo tập dữ liệu trước đây.
Tất cả điểm trong tập dữ liệu cho trước sẽ được trả về bằng các lệnh gọi tiếp theo để truy xuất tập dữ liệu này. Các điểm dữ liệu có thể thuộc về nhiều tập dữ liệu.
Phương thức này không sử dụng ngữ nghĩa của bản vá: các điểm dữ liệu được cung cấp chỉ được chèn vào, không có dữ liệu hiện có nào được thay thế.
Thử ngay.
Yêu cầu
Yêu cầu HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
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. |
datasetId |
string |
Trường này không được sử dụng và có thể được bỏ qua một cách an toàn. |
userId |
string |
vá tập 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.
|
Ủ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.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
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
Trong nội dung yêu cầu, hãy cung cấp các phần liên quan của tài nguyên User.dataSources.datasets, theo các quy tắc của ngữ nghĩa của bản vá, với các thuộc tính sau:
| Tên tài sản | Giá trị | Nội dung mô tả | Lưu ý |
|---|---|---|---|
| Thuộc tính bắt buộc | |||
dataSourceId |
string |
Mã luồng dữ liệu của nguồn dữ liệu đã tạo các điểm trong tập dữ liệu này. | |
maxEndTimeNs |
long |
Thời gian kết thúc lớn nhất của tất cả các điểm dữ liệu trong bản trình bày một phần này của tập dữ liệu. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Giá trị này cũng phải khớp với phần thứ hai của giá trị nhận dạng tập dữ liệu. | |
minStartTimeNs |
long |
Thời gian bắt đầu nhỏ nhất của tất cả các điểm dữ liệu trong bản trình bày một phần này của tập dữ liệu. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Giá trị này cũng phải khớp với phần đầu tiên của giá trị nhận dạng tập dữ liệu. | |
point[] |
list |
Một phần danh sách các điểm dữ liệu có trong tập dữ liệu, được sắp xếp theo endTimeNanos. Danh sách này được coi là đầy đủ khi truy xuất một tập dữ liệu nhỏ và một phần khi vá một tập dữ liệu hoặc truy xuất tập dữ liệu quá lớn để đưa vào một phản hồi. | |
point[].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. | |
point[].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. | |
point[].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. | |
point[].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. |
|
Phản hồi
Nếu thành công, phương thức này sẽ trả về tài nguyên User.dataSources.datasets trong nội dung phản hồi.
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.