Users.dataSources.datasets: patch

Thêm các điểm dữ liệu vào một tập dữ liệu. Tập dữ liệu không cần được tạo trước đó. Tất cả các điểm trong tập dữ liệu đã cho sẽ được trả về bằng các lệnh gọi phụ để 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 mà 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

Thông 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à bạn có thể bỏ qua một cách an toàn.
userId string Vá một tập 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 tại, hệ thống chỉ hỗ trợ me.

Ủy quyền

Yêu cầu này cần được 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à uỷ quyền.

Nội dung yêu cầu

Trong nội dung yêu cầu, cung cấp các phần liên quan của tài nguyên Users.dataSources.datasets theo quy tắc về 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ả Ghi chú
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 phần biểu thị một phần của tập dữ liệu này. 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 phần biểu thị một phần có thể của tập dữ liệu này. Thời gian tính bằng nano giây kể từ thời gian bắt đầu của hệ thống. Phần phụ thuộc 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 Danh sách một phần 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à hoàn chỉnh khi truy xuất một tập dữ liệu nhỏ và một phần khi đang vá một tập dữ liệu hoặc truy xuất mộ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 từng 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 thứ tự mà trường được liệt kê trong loại dữ liệu được chỉ định trong một nguồn dữ liệu.

Chỉ điền một trong các trường số nguyên và dấu phẩy động, tuỳ thuộc vào giá trị enum định dạng trong trường loại 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ề một tài nguyên Users.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.