Users.dataSources: update

Cập nhật nguồn dữ liệu được chỉ định. dataStreamId, dataType, type, dataStreamName và device ngoại trừ version, Không thể sửa đổi.

Nguồn dữ liệu được xác định bằng dataStreamId. Thử ngay.

Yêu cầu

Yêu cầu HTTP

PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId

Tham số

Tên thông số Giá trị 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 để xác định người dùng đã xác thực. Chỉ có me được hỗ trợ tại thời điểm này bất cứ lúc nào.

Ủy quyền

Yêu cầu này cần có sự 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ị Mô tả Ghi chú
Thuộc tính bắt buộc
application nested object Thông tin về một ứng dụng cung cấp dữ liệu cảm biến cho nền tảng.
application.name string Tên của ứng dụng này. Điều này là bắt buộc đối với các ứng dụng REST, nhưng chúng tôi không thực thi tính duy nhất của tên này. API 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 này bao gồm:

  • Nhà sản xuất, kiểu máy và số sê-ri (UID) của thiết bị thực.
  • Tên hoặc tên gói của ứng dụng. Tên gói được dùng khi một ứng dụng Android tạo nguồn dữ liệu. Số dự án của nhà phát triển được dùng khi ứng dụng REST tạo nguồn dữ liệu.
  • Loại nguồn dữ liệu.
  • Tên luồng của nguồn dữ liệu.
Xin lưu ý rằng không phải tất cả thuộc tính của nguồn dữ liệu đều được dùng làm giá trị nhận dạng luồng. Đặc biệt, phiên bản phần cứng/ứng dụng không được sử dụng. Điều này cho phép chúng tôi giữ nguyên một luồng thông qua việc cập nhật phiên bản. Điều này cũng có nghĩa là 2 đối tượng DataSource có thể đại diện cho cùng một luồng dữ liệu ngay cả khi chúng không bằng nhau.

Định dạng chính xác của mã luồng dữ liệu do ứng dụng Android tạo ra là: type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

Đị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:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

Nếu 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, các trường đó sẽ bị loại bỏ khỏi mã luồng dữ liệu. Mã luồng dữ liệu khả thi tối thiểu sẽ là: type:dataType.name:số dự án nhà phát triển

Cuối cùng, số dự án nhà phát triển và UID thiết bị bị làm rối mã nguồn khi đọc bởi bất kỳ ứng dụng REST hoặc Android nào không tạo ra nguồn dữ liệu. Chỉ người tạo nguồn dữ liệu mới nhìn thấy số dự án của nhà phát triển ở dạng rõ ràng và bình thường. Điều này có nghĩa là khách hàng sẽ thấy tập hợp data_stream_ids khác với một khách hàng khác có thông tin đăng nhập 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 Trường đại diện cho một phương diện của 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 chấp nhận là:
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
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ó vùng chứa tên và chỉ cần 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 riêng biệt có không gian tên. Tất cả các loại dữ liệu trong không gian 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ể chứa 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 thiết bị hiển thị cho người dùng cuối.
device.type string Một hằng số đại diện cho loại thiết bị.

Các giá trị được chấp nhận là:
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
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 ra nguồn dữ liệu. Chỉ người tạo nguồn dữ liệu mới nhìn thấy trường uid ở dạng rõ ràng và bình thường.

Quy trình làm rối mã nguồn duy trì sự bình đẳng; tức là với hai mã nhận dạng, nếu id1 == id2, làm rối mã nguồn(id1) == 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 chấp nhận là:
  • "derived"
  • "raw"

Phản hồi

Nếu thành công, phương thức này sẽ trả về tài nguyên Users.dataSources trong nội dung phản hồi.

Hãy dùng thử!

Hãy sử dụng APIs Explorer (Trình khám phá API) 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.