範圍

所有讀取及寫入使用者資料的 Google 健康 API 端點，都必須透過一或多個範圍取得使用者同意聲明，才能收集資料。應用程式呼叫 Google 的 OAuth2 授權端點時，必須提供範圍清單。請參閱「取得 OAuth2 存取權杖」。核發的存取權杖只會包含同意授權的使用者授權的範圍。

所有 Google Health API 範圍都以以下內容開頭：

https://www.googleapis.com/auth/googlehealth

導入作業

為提供最佳使用者體驗並確保符合安全規定，要求範圍時請注意下列事項：

• 只要求必要的範圍：只要求存取應用程式運作所需的特定資料範圍。
• 只在傳送資料時設定寫入存取權：只有在將資料傳送至 Google Health 時，才設定「寫入」存取權 (例如使用 writeonly 範圍)。
• 妥善處理部分同意聲明：如果使用者未選取同意畫面上的所有範圍，應用程式不應失敗。
  • 如果應用程式需要所有顯示的範圍才能運作，您可以顯示以下文字：「為提供最佳使用者體驗，建議啟用所有範圍。」

可用範圍

表格：Google Health API 範圍

範圍	權限
.activity_and_fitness.readonly	查看 Google Health 活動和健身資料。
.activity_and_fitness.writeonly	在 Google 健康新增活動和健身資料，以及編輯或刪除所新增的資料。
.ecg.readonly	查看 Google Health 心電圖資料。
.health_metrics_and_measurements.readonly	查看 Google Health 的健康指標和測量資料。
.health_metrics_and_measurements.writeonly	在 Google Health 新增健康指標和測量資料，以及編輯或刪除所新增的資料。
.irn.readonly	查看 Google Health 心律不整通知資料。
.location.readonly	查看您運動期間記錄的 Google Health GPS 位置資訊。
.nutrition.readonly	查看 Google Health 營養資料。
.nutrition.writeonly	在 Google Health 新增營養資料，以及編輯或刪除所新增的資料。
.profile.readonly	查看 Google Health 設定檔資料。
.profile.writeonly	在 Google Health 新增設定檔資料，以及編輯或刪除所新增的資料。
.settings.readonly	查看 Google Health 設定。
.settings.writeonly	在 Google Health 新增設定資料，以及編輯或刪除所新增的資料。
.sleep.readonly	查看 Google Health 睡眠資料。
.sleep.writeonly	在 Google 健康新增睡眠資料，以及編輯或刪除所新增的資料。