開發人員檢查清單

這份檢查清單概述了推出整合 Google Health API 應用程式的建議步驟。

1. 事前準備

查看開發人員說明文件：瞭解資料類型、範圍和 API 端點，判斷整合作業需要哪些項目。

查看 Google Health API 政策：確保您的用途符合《Google Health API 開發人員條款及細則》和《Google Health API 開發人員和使用者資料政策》。

規劃使用者體驗：如果從 Fitbit Web API 遷移使用者，請參閱遷移指南中的最佳做法，瞭解如何處理使用者重新驗證。

2. 設定整合

設定 Google Cloud：按照「設定 Google Cloud 和 OAuth」一文中的操作說明，建立 Google Cloud 專案、啟用 Google Health API，並設定 OAuth 2.0 憑證。請為預備環境和實際工作環境使用不同的專案，以免測試影響正式上線的應用程式。

設定 OAuth 同意畫面：在 Google Cloud 控制台中，使用應用程式資訊、品牌和應用程式隱私權政策與服務條款的連結，設定 OAuth 同意畫面。

新增範圍：在 Google Cloud 控制台中，新增應用程式需要存取的資料類型所需的範圍。查看範圍實作，例如只要求必要的範圍、只在傳送資料時設定寫入存取權，以及妥善處理部分同意聲明。

3. 開發及測試

發出第一個 API 呼叫：如果您是 Google Health API 的新手，請按照Codelab的指示操作，在幾分鐘內發出第一個 API 呼叫。

從 Fitbit Web API 遷移：如要從 Fitbit Web API 遷移，請參閱遷移指南，並使用對等工具比較 API。

導入 OAuth 2.0：導入 OAuth 2.0 授權，取得使用者同意聲明和 API 權杖。使用用戶端程式庫簡化實作程序。

新增測試使用者：在 Google Cloud 中，如果應用程式處於「測試中」模式，請新增測試使用者，測試與允許清單中帳戶的整合。

擷取資料：使用適當的資料類型端點擷取使用者資料。請遵循擷取歷史資料的最佳做法，將這項作業與新手上路程序分開，因為所有資料期間的速率限制都是固定的。

處理錯誤：請參閱疑難排解指南，瞭解常見錯誤和處理方式。

使用訂閱項目的 Webhook：使用 Subscription API 接收即時通知，而非輪詢。將傳入的通知放入佇列，並分別處理。請參閱網路鉤子最佳做法。

4. 準備發布

OAuth 驗證：如果應用程式需要支援超過 100 位使用者，或是您已準備好公開發布應用程式，請提交應用程式以進行 OAuth 驗證。這個程序可能需要數天，包括第三方安全審查，以及驗證應用程式的隱私權政策和服務條款。

Fitbit Web API 遷移：如果正在遷移，請確保遷移使用者的重新驗證流程順暢，並遵循遷移指南中的建議。

5. 推出及維護

發布應用程式：完成 OAuth 驗證後，請將應用程式發布至 Google Cloud 控制台的「正式版」，即可解除 100 位使用者的人數限制。

監控：在 Google Cloud 控制台中監控 API 使用量和錯誤率。

掌握最新動態：隨時查看版本資訊，瞭解 API 更新和淘汰情形。