开始使用

欢迎使用 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。Codelab 将向您展示如何设置 Google Cloud 云项目、OAuth 2.0 Web 客户端，以及如何使用 Visual Studio Code 成功首次调用 Google Health API。

打开 Codelab

Fitbit 开发者

如果您是 Fitbit Web API 的现有开发者， 建议您先阅读迁移指南。该指南重点介绍了 Fitbit Web API 和 Google Health API 之间的所有差异，并应提供您开始规划迁移所需的指导。

本指南还重点介绍了最佳实践和界面示例，以帮助引导用户完成重新身份验证流程。

之后，您可以学习 Codelab，也可以先验证 Google Cloud 设置是否已完成，然后再开始使用我们的其中一个数据类型指南进行开发。

阅读迁移指南 完成 Google Cloud 设置

选择协议

Google Health API 同时支持 REST 和 RPC 协议，为开发者提供可扩缩且高性能的健康数据集成基础。

REST

REST 是一种基于标准 Web 概念和人类可读格式（例如 JSON）的 API 设计方法。它特别适合构建公共 API 和 Web 应用，因为它对浏览器友好且受到广泛支持。它的主要优势在于其简单性和外部开发者的可访问性。

gRPC

RPC 是一种高性能系统，它使用称为协议缓冲区的紧凑型二进制格式来促进机器间通信。由于其效率和对流式传输等高级功能的支持，它非常适合内部微服务、移动设备到后端通信和实时更新。对于高性能场景或需要严格的接口协定时，RPC 是首选。

如需了解详情，请参阅 gRPC 与 REST：了解 gRPC、OpenAPI 和 REST 以及何时在 API 设计中使用它们。

资源

除了入门指南之外，本网站还提供全面的资源来帮助您进行开发和迁移。

  • 支持：需要帮助？您可以在支持页面上访问社区论坛 和我们的公开问题跟踪器。
  • Google Health API 对等工具：使用此 工具比较 Fitbit Web API 和 Google Health API 之间的端点和 功能。它还提供了一个上下文的描述文件，您可以直接将其与 LLM 搭配使用，也可以将其作为首选 AI 工具中的 Agents.md 文件的一部分使用。
  • API 参考文档：完整的 REST 参考 文档。