Cập nhật nguồn dữ liệu đã chỉ định. Bạn không thể sửa đổi các thuộc tính dataStreamId
, dataType
, type
, dataStreamName
và device
(ngoại trừ version
).
Nguồn dữ liệu được xác định bằng dataStreamId
của chúng.
Thử ngay.
Yêu cầu
Yêu cầu HTTP
PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId
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 cần cập nhật. |
userId |
string |
Cập nhật nguồn 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. Tại thời điểm này, 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, hãy cung cấp tài nguyên Users.dataSources 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 | |||
application |
nested object |
Thông tin về một ứng dụng cấp dữ liệu cảm biến vào nền tảng. | |
application.name |
string |
Tên của ứng dụng này. Đây là tên bắt buộc đối với các khách hàng REST, nhưng chúng tôi không áp dụng tên duy nhất cho tên này. Việc này được cung cấp để thuận tiện cho các nhà phát triển khác muốn xác định REST nào đã tạo Ứng dụng hoặc Nguồn dữ liệu. | |
dataStreamId |
string |
Giá trị nhận dạng duy nhất cho luồng dữ liệu do nguồn dữ liệu này tạo ra. Giá trị nhận dạng bao gồm:
Định dạng chính xác của mã luồng dữ liệu do ứng dụng Android tạo là: type:dataType.name Định dạng chính xác của mã luồng dữ liệu do ứng dụng REST tạo là: type:dataType.name Khi không có bất kỳ trường không bắt buộc nào tạo nên mã luồng dữ liệu, thì mã này sẽ bị loại bỏ khỏi mã luồng dữ liệu. Mã luồng dữ liệu khả dụng tối thiểu sẽ là: type:dataType.name:developer dự án Cuối cùng, mã dự án nhà phát triển và UID của thiết bị sẽ bị làm rối khi được đọc bởi bất kỳ ứng dụng REST hoặc Android nào không tạo nguồn dữ liệu. Chỉ người tạo nguồn dữ liệu mới thấy số dự án của nhà phát triển ở dạng rõ ràng và thông thường. Tức là khách hàng sẽ thấy tập hợp data_stream_ids khác với tập hợp dữ liệu của một khách hàng khác có thông tin xác thực khác. |
|
dataType |
nested object |
Loại dữ liệu xác định giản đồ cho luồng dữ liệu được thu thập, chèn vào hoặc truy vấn từ Fitness API. | |
dataType.field[] |
list |
Một trường đại diện cho một phương diện của một loại dữ liệu. | |
dataType.field[].format |
string |
Các định dạng được hỗ trợ khác nhau cho mỗi trường trong một loại dữ liệu.
Các giá trị có thể chấp nhận là:
|
|
dataType.field[].name |
string |
Xác định tên và định dạng của dữ liệu. Không giống như tên loại dữ liệu, tên trường không được đặt tên trong vùng chứa tên mà chỉ cần phải là duy nhất trong loại dữ liệu. | |
dataType.name |
string |
Mỗi loại dữ liệu có một tên duy nhất trong không gian tên. Tất cả các loại dữ liệu trong vùng chứa tên com.google đều được chia sẻ như một phần của nền tảng. | |
device |
nested object |
Hình ảnh minh hoạ một thiết bị tích hợp (chẳng hạn như điện thoại hoặc thiết bị đeo) có thể giữ cảm biến. | |
device.manufacturer |
string |
Nhà sản xuất sản phẩm/phần cứng. | |
device.model |
string |
Tên mẫu mà người dùng cuối nhìn thấy cho thiết bị. | |
device.type |
string |
Hằng số biểu thị loại thiết bị.
Các giá trị có thể chấp nhận là:
|
|
device.uid |
string |
Số sê-ri hoặc mã nhận dạng duy nhất khác của phần cứng. Trường này bị làm rối mã nguồn khi được đọc bởi bất kỳ ứng dụng REST hoặc Android nào không tạo nguồn dữ liệu. Chỉ người tạo nguồn dữ liệu mới thấy trường uid ở dạng rõ ràng và bình thường. Việc làm rối mã nguồn sẽ duy trì đẳng thức; tức là khi có hai mã nhận dạng, nếu id1 == id2, làm rối mã nguồn(id1) == bị làm rối mã nguồn(id2). |
|
device.version |
string |
Chuỗi phiên bản cho phần cứng/phần mềm của thiết bị. | |
type |
string |
Hằng số mô tả loại nguồn dữ liệu này. Cho biết nguồn dữ liệu này tạo ra dữ liệu thô hay dữ liệu phái sinh.
Các giá trị có thể chấp nhận là:
|
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 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.