Khắc phục sự cố

Hướng dẫn này giải thích cách khắc phục các vấn đề thường gặp khi sử dụng Google Health API.

Lỗi 4xx của ứng dụng

Mã trạng thái 4xx được trả về khi có vấn đề trong mã ứng dụng khách. Hãy xem các phần tử trong nội dung phản hồi để biết thêm thông tin về vấn đề.

400 Yêu cầu không hợp lệ

Nhắn tin Mô tả Nội dung đề xuất
Yêu cầu chứa đối số không hợp lệ. Không hỗ trợ mã nhận dạng loại dữ liệu {value}. Xác minh rằng loại dữ liệu được tham chiếu được điểm cuối hỗ trợ.
Đã nhận được tải trọng JSON không hợp lệ. Số bát phân/số thập lục phân không phải là giá trị JSON hợp lệ. Điểm cuối dailyRollUp không hỗ trợ các giá trị tháng và ngày được biểu thị lần lượt là MM hoặc DD. Các chữ số đơn không được có số 0 ở đầu.
Số dự án không hợp lệ trong tên tài nguyên Khi xoá hoặc cập nhật người đăng ký bằng mã dự án trên Google Cloud trong URL yêu cầu thay vì số dự án. Điều này áp dụng cho các gói thuê bao webhook sử dụng điểm cuối projects.subscribers. Sử dụng số dự án trên đám mây của Google trong URL yêu cầu, chứ không phải mã dự án.

401 Không được phép

Nhắn tin Mô tả Nội dung đề xuất
Yêu cầu có thông tin xác thực không hợp lệ. Mã truy cập OAuth 2, cookie đăng nhập hoặc thông tin xác thực hợp lệ khác dự kiến. INVALID_AUTHENTICATOR: Mã thông báo đã hết hạn Mã truy cập của bạn đã hết hạn. Sử dụng mã làm mới để lấy mã truy cập và mã làm mới mới, hoặc người dùng phải đồng ý lại với ứng dụng.

403 Bị cấm

Nhắn tin Mô tả Nội dung đề xuất
Phương thức gọi không có quyền Khi tạo hoặc liệt kê người đăng ký, hãy sử dụng mã dự án trên Google Cloud trong URL yêu cầu thay vì số dự án. Điều này áp dụng cho các gói thuê bao webhook sử dụng điểm cuối projects.subscribers. Sử dụng số dự án trên đám mây của Google trong URL yêu cầu, chứ không phải mã dự án.
Người gọi không có quyền. Không thể đúc UberMint từ GaiaMint.

Người dùng có thể hoàn tất quy trình uỷ quyền, nhưng lệnh gọi điểm cuối không thành công. Điều này có thể xảy ra khi một tài khoản Fitbit cũ đồng ý cho ứng dụng thay vì Tài khoản Google. Cách giải quyết lỗi này:

  1. Đăng xuất khỏi ứng dụng Fitbit thông qua phần cài đặt của Fitbit.
  2. Đăng nhập vào ứng dụng Fitbit bằng cách nhấn vào nút "Tiếp tục bằng Google" hoặc "Đăng nhập bằng Google". Nếu bạn nhận được thông báo "Không thể dùng Fitbit bằng Tài khoản Google này", thì có nghĩa là địa chỉ email của bạn vẫn được đăng ký làm tài khoản Fitbit cũ. Hãy làm theo các bước trong bài viết trợ giúp này để di chuyển tài khoản.

404 Không tìm thấy

Nhắn tin Mô tả Nội dung đề xuất
Không tìm thấy URL được yêu cầu /v4/users/me/dataTypes/{dataType}/dataPoints trên máy chủ này. Nguyên nhân có thể dẫn đến việc này:
  • Xác minh rằng bạn đang sử dụng động từ chính xác
  • Kiểm tra xem cú pháp điểm cuối có lỗi chính tả không

Truy xuất mã nhận dạng người dùng Fitbit

Để khắc phục sự cố của người dùng, bạn có thể cần xác minh Tài khoản Google của người dùng đã đăng nhập vào ứng dụng Fitbit.

Cách tìm mã nhận dạng người dùng Fitbit:

  1. Mở ứng dụng Fitbit.
  2. Nhấn vào biểu tượng Bạn ở góc dưới cùng bên phải.
  3. Nhấn vào đường liên kết Chỉnh sửa hồ sơ trong ô trên cùng có tên người dùng và ngày tham gia.
  4. Chuyển tới cuối trang. Trong mục Tài khoản của bạn, giá trị được chỉ định cho mã nhận dạng là mã nhận dạng người dùng Fitbit. (Ví dụ: CV5TKH)

Khi giúp người dùng khắc phục sự cố liên quan đến kết nối OAuth2 với ứng dụng của bạn, có thể bạn cần họ huỷ liên kết tài khoản với ứng dụng của bạn rồi hoàn tất lại quy trình uỷ quyền.

Cách huỷ liên kết Tài khoản Google của họ khỏi ứng dụng của bạn:

  1. Mở ứng dụng Fitbit.
  2. Nhấn vào biểu tượng hồ sơ người dùng Fitbit ở góc trên cùng bên phải.
  3. Nhấn vào Quản lý Tài khoản Google của bạn.
  4. Chọn ô Dữ liệu và quyền riêng tư.
  5. Chuyển đến phần **Dữ liệu trên những ứng dụng và dịch vụ bạn sử dụng. Trong mục Ứng dụng và dịch vụ, hãy chọn Ứng dụng và dịch vụ bên thứ ba.
  6. Tìm tên ứng dụng của bạn trong danh sách các ứng dụng đã kết nối và yêu cầu người dùng chọn ứng dụng đó.
  7. Nhấn vào Xoá tất cả kết nối bạn có với <tên ứng dụng>.
  8. Yêu cầu người dùng nhấn vào nút xác nhận để thu hồi sự đồng ý đối với ứng dụng của bạn.

Khi quá trình thu hồi hoàn tất, người dùng sẽ được đưa trở lại danh sách trên trang Ứng dụng và dịch vụ của bên thứ ba. Người dùng có thể cần làm mới trang để thấy tên ứng dụng đã bị xoá khỏi danh sách.

Khắc phục sự cố chậm trễ khi đồng bộ hoá thiết bị

Khi gỡ lỗi các vấn đề liên quan đến dữ liệu người dùng bị thiếu hoặc bị trì hoãn, bạn nên kiểm tra mô hình thiết bị đã ghép nối của người dùng và ngày đồng bộ hoá gần đây nhất của họ.

Thông tin về mẫu thiết bị (chẳng hạn như mẫu vòng đeo tay theo dõi hoặc đồng hồ thông minh Fitbit) và ngày đồng bộ hoá gần nhất rất hữu ích cho việc khắc phục sự cố và tìm nạp dữ liệu trong quá khứ sau khi đồng bộ hoá bị chậm trễ.

Ví dụ: nếu bạn nhận thấy có khoảng trống hoặc độ trễ không mong muốn trong việc phân phối dữ liệu:

  1. Xác minh rằng mã nhận dạng người dùng mà bạn đang truy vấn khớp với mã nhận dạng người dùng của tài khoản Fitbit đã đăng nhập vào ứng dụng di động. Để lấy mã nhận dạng người dùng trong ứng dụng di động, hãy xem phần Truy xuất mã nhận dạng người dùng Fitbit. Để lấy mã nhận dạng người dùng từ mã truy cập, hãy gọi điểm cuối getIdentity.
  2. Kiểm tra thời gian đồng bộ hoá gần đây nhất để xác định thời điểm thiết bị của người dùng đồng bộ hoá lần gần đây nhất với ứng dụng di động Google Health.
  3. Nếu thiết bị chưa đồng bộ hoá gần đây, thì điều này cho thấy độ trễ có thể là do thiết bị đang ở trạng thái ngoại tuyến hoặc không đồng bộ hoá với ứng dụng di động, chứ không phải do vấn đề về API.
  4. Sau khi người dùng mở ứng dụng di động và đồng bộ hoá thiết bị, bạn có thể tìm nạp dữ liệu cũ cho khoảng thời gian kể từ lần đồng bộ hoá gần đây nhất.

Để truy xuất thông tin về thiết bị đã ghép nối của người dùng, hãy gọi điểm cuối users.pairedDevices.list. Thao tác này sẽ trả về danh sách các thiết bị chứa:

  • deviceVersion: Tên sản phẩm hoặc kiểu máy của thiết bị (ví dụ: "Charge 6").
  • lastSyncTime: Dấu thời gian của lần đồng bộ hoá thành công gần đây nhất.
Trước
Đăng ký webhook