欢迎使用 Google Health API!
此新 API 利用 Google OAuth,提供了一种更安全、更易于使用且可扩缩的健康数据访问和管理解决方案。以下是一些好处:
增强的安全性:新 API 符合 Google 当前针对 API 设计和实现提出的安全建议和最佳实践,可降低出现安全漏洞的风险。
一致性:新 API 遵循现代 API 设计原则,可提供更一致、更直观的开发者体验。
面向未来的设计
- 可伸缩性:新 API 旨在实现可伸缩性,以满足未来需求,支持不断增长的用户数量和数据类型。
- 可维护性:采用标准化方法可更轻松地维护和更新应用,从而减少技术债务。
- 使用新功能:迁移到新 API 后,您可以使用新发布的功能,确保应用保持最新状态并受益于最新进展。
- 合规性:新 API 会根据最新的 Google 安全和隐私保护标准及时更新,从而减少保持应用合规所需的工作量。
- 数据隐私权:Google OAuth 系统旨在遵守各种数据隐私权法规(例如 GDPR 和 HIPAA),从而减轻开发者的合规负担。
如何开始?
在开始开发之前,请参阅我们的开发者清单,其中列出了有助于您启动与 Google Health API 集成的步骤。
入门方式还取决于您是哪种类型的开发者。
新开发者
如果您没有 Google API 或 Google Cloud 经验,或者需要复习一下,最简单快捷的入门方法是学习我们的某个 Codelab。我们提供了使用 Visual Studio Code 或 OAuth 2.0 Playground 的 REST Codelab,以及一个专门针对 gRPC 的 Python Codelab,您可以在其中学习如何检索客户端桩并编译 Protocol Buffer 定义。
REST Codelab (VS Code) REST Codelab (OAuth 2.0 Playground) gRPC Codelab (Python)
Fitbit 开发者
如果您是现有的 Fitbit Web API 开发者,不妨先阅读迁移指南。该文档重点介绍了 Fitbit Web API 与 Google Health API 之间的所有差异,并应能为您提供开始规划迁移所需的指导。
本指南还重点介绍了最佳实践和界面示例,以帮助引导用户完成重新身份验证流程。
之后,您可以完成此 Codelab,也可以先验证 Google Cloud 设置是否已完成,然后再开始使用我们的某个数据类型指南进行开发。
选择协议
Google Health API 同时支持 REST 和 RPC 协议,可为开发者提供可扩缩的高性能健康数据集成基础。
REST
REST 是一种基于标准 Web 概念和 JSON 等人类可读格式的 API 设计方法。它非常适合构建公共 API 和 Web 应用,因为其浏览器兼容性好且受广泛支持。它的主要优势在于简单易用,外部开发者可以轻松上手。
gRPC
RPC 是一种高性能系统,它使用称为协议缓冲区的紧凑型二进制格式来促进机器间通信。由于其效率高且支持流式传输等高级功能,因此非常适合内部微服务、移动设备到后端通信和实时更新。对于高性能场景或需要严格的接口合约时,RPC 是首选。
如需了解详情,请参阅 gRPC 与 REST:了解 gRPC、OpenAPI 和 REST 以及何时在 API 设计中使用它们。
AI 辅助功能和开发者工具
您可以在本网站上使用 Google 的 AI 助理 Gemini 和内置的开发者工具,加快 Google Health API 工作流程。在浏览时,您可以使用信息面板中的 Gemini Chat 和代码说明功能来总结复杂的指南、阐明数据类型和范围,或将代码示例调整为您的语言。您还可以在 APIs Explorer 中测试实时请求,并使用 JSON 响应作为提示上下文来生成解析逻辑。
如果您使用 Antigravity、Cursor、Claude Code 或自定义智能体等 AI 赋能的工具进行开发,则可以将任何页面导出为 Markdown,或集成 Developer Knowledge MCP 服务器,以便您的环境直接访问 Google Health API 文档。您可以使用这些工作流来生成客户端代码或排查错误。如需了解详情,请参阅 AI 辅助功能和开发者工具。
资源
除了入门指南之外,此网站还提供全面的资源来帮助您进行开发和迁移。