疑難排解

本指南說明如何排解使用 Google 健康資料 API 時的常見問題。

4xx 用戶端錯誤

如果用戶端應用程式程式碼有問題，系統會傳回 4xx 狀態碼。查看回應主體元素，進一步瞭解問題。

400 錯誤的要求

訊息 說明 建議
要求含有無效引數。 不支援資料類型 ID「{value}」。 確認端點支援所參照的資料類型。
收到無效的 JSON 酬載。八進位/十六進位數字不是有效的 JSON 值。 dailyRollUp 端點不支援以 MM 或 DD 分別表示的月份和日期值。個位數不得以 0 開頭。
資源名稱中的專案編號無效 使用要求網址中的 Google Cloud 雲端專案 ID 刪除或更新訂閱者，而非專案編號。這適用於使用 projects.subscribers 端點的 Webhook 訂閱項目。 請在要求網址中使用 Google Cloud 專案編號，而非專案 ID。

401 未獲授權

訊息 說明 建議
要求的驗證憑證無效。Expected OAuth 2 access token, login cookie or other valid authentication credential. INVALID_AUTHENTICATOR：權杖已過期 您的存取權杖已過期。使用更新權杖取得新的存取權杖和更新權杖，或請使用者重新同意應用程式存取權。

403 Forbidden

訊息 說明 建議
呼叫者沒有權限 使用 Google Cloud 雲端專案 ID 建立或列出訂閱端時，請在要求網址中加入專案 ID，而非專案編號。這適用於使用 projects.subscribers 端點的 Webhook 訂閱項目。 請在要求網址中使用 Google Cloud 專案編號，而非專案 ID。
呼叫者沒有權限。 無法從 GaiaMint 鑄造 UberMint。

使用者已完成授權流程，但端點呼叫失敗。如果舊版 Fitbit 帳戶同意應用程式存取資料，而非 Google 帳戶，就可能發生這種情況。如要解決這項錯誤，請按照下列步驟操作：

  1. 透過 Fitbit 設定登出 Fitbit 行動應用程式。
  2. 按下「使用 Google 繼續」或「使用 Google 帳戶登入」按鈕，登入 Fitbit 行動應用程式。如果收到「無法使用這個 Google 帳戶存取 Fitbit」訊息，表示你的電子郵件地址仍註冊為舊版 Fitbit 帳戶。請按照這篇說明文章的步驟遷移帳戶。

404 找不到網頁

訊息 說明 建議
在此伺服器上找不到所要的網址 /v4/users/me/dataTypes/{dataType}/dataPoints。 可能原因：
  • 確認使用的動詞是否正確
  • 檢查端點語法是否有錯字

擷取 Fitbit 使用者 ID

如要協助排解使用者問題，您可能需要驗證使用者登入 Fitbit 行動應用程式的 Google 帳戶。

如何找出 Fitbit 使用者 ID：

  1. 開啟 Fitbit 行動應用程式。
  2. 按下右下角的「個人中心」圖示。
  3. 按一下頂端含有使用者名稱和加入日期的方塊中的「編輯個人資料」連結。
  4. 瀏覽至頁面底部。在「你的帳戶」部分，指派給 ID 的值就是 Fitbit 使用者 ID。(例如：CV5TKH)

協助使用者排解應用程式的 OAuth 2 連線問題時，您可能需要請他們取消連結帳戶與應用程式，然後再次完成授權流程。

如要取消 Google 帳戶與應用程式的連結，請按照下列步驟操作：

  1. 開啟 Fitbit 行動應用程式。
  2. 按一下右上角的 Fitbit 使用者個人資料圖示。
  3. 按一下「管理你的 Google 帳戶」。
  4. 選取「資料和隱私權」動態磚。
  5. 向下捲動至「您在應用程式和服務中的資料」部分。 在「應用程式和服務」下方，選取「第三方應用程式和服務」。
  6. 在已連結的應用程式清單中尋找您的應用程式名稱，然後請使用者選取該應用程式。
  7. 按一下「刪除你與『<應用程式名稱>』之間的所有連結」。
  8. 請使用者按下確認鍵，撤銷對您應用程式的同意聲明。

撤銷程序完成後，使用者會返回「第三方應用程式和服務」頁面。使用者可能需要重新整理頁面，才能看到應用程式名稱從清單中移除。

上一頁
Webhook 訂閱項目