使ってみる

Google Health API へようこそ。

この新しい API は Google OAuth を活用しており、健康に関するデータへのアクセスと管理のための、より安全でユーザー フレンドリーなスケーラブル ソリューションを提供します。特典は次のとおりです。

  • セキュリティの強化: 新しい API は、API の設計と実装に関する Google の現在のセキュリティ推奨事項とベスト プラクティスに準拠しており、脆弱性のリスクを軽減します。

  • 整合性: 新しい 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 と、クライアント スタブの取得方法と Protocol Buffer 定義のコンパイル方法を学習する gRPC 固有の Python Codelab を提供しています。

REST Codelab(VS Code) REST Codelab(OAuth 2.0 Playground) gRPC Codelab(Python)

Fitbit デベロッパー

Fitbit Web API をすでに利用しているデベロッパーの方は、まず移行ガイドをお読みください。Fitbit Web API と Google Health API のすべての違いが強調表示され、移行の計画を開始するために必要なガイダンスが提供されます。

このガイドでは、再認証プロセスでお客様をサポートするうえで役立つベスト プラクティスと UI サンプルも紹介します。

その後、コードラボを実施するか、Google Cloud の設定が完了していることを確認してから、データ型ガイドのいずれかを使用して開発を開始します。

移行ガイドを読む Google Cloud の設定を完了する

プロトコルを選択する

Google Health API は REST プロトコルと RPC プロトコルの両方をサポートしており、健康に関するデータ統合のためのスケーラブルで高性能な基盤をデベロッパーに提供します。

REST

REST は、標準的なウェブのコンセプトと JSON などの人間が読める形式に基づく API 設計アプローチです。ブラウザとの相性がよく、幅広くサポートされているため、特にパブリック API やウェブ アプリケーションの構築に適しています。主な強みは、外部のデベロッパーにとってのシンプルさとアクセシビリティです。

gRPC

RPC は、プロトコル バッファと呼ばれるコンパクトなバイナリ形式を使用して、マシン間の通信を容易にする高性能システムです。効率性に優れ、ストリーミングなどの高度な機能をサポートしているため、内部マイクロサービス、モバイルとバックエンド間の通信、リアルタイム更新に最適です。RPC は、高パフォーマンスのシナリオや厳密なインターフェース契約が必要な場合に推奨されます。

詳細については、gRPC と REST の比較: gRPC、OpenAPI、REST の概要と、それらを API 設計で使用するタイミングを理解するをご覧ください。

AI アシスタンスとデベロッパー ツール

このサイトでは、Google の AI アシスタントである Gemini と組み込みのデベロッパー ツールを使用して、Google Health API のワークフローを加速できます。ブラウジング中に、情報パネルの Gemini チャットとコード説明を使用して、複雑なガイドを要約したり、データ型とスコープを明確にしたり、コードサンプルを自分の言語に適合させたりできます。API Explorer でライブ リクエストをテストし、JSON レスポンスをプロンプト コンテキストとして使用して、解析ロジックを生成することもできます。

Antigravity、Cursor、Claude Code などの AI 搭載ツールやカスタム エージェントを使用して開発する場合は、任意のページを Markdown としてエクスポートするか、Developer Knowledge MCP サーバーを統合して、環境から Google Health API ドキュメントに直接アクセスできるようにします。これらのワークフローを使用して、クライアント コードを生成したり、エラーのトラブルシューティングを行ったりします。詳細については、AI アシスタンスとデベロッパー ツールをご覧ください。

リソース

このサイトでは、開発と移行を支援する包括的なリソースも提供しています。

  • サポート: サポートが必要な場合は、サポートページで、コミュニティ フォーラムと公開 Issue Tracker にアクセスできます。
  • Google Health API Parity Tool: このツールを使用して、Fitbit Web API と Google Health API のエンドポイントと機能を比較します。また、LLM で直接使用できるコンテキスト ファイルや、お好みの AI ツールで Agents.md ファイルの一部として使用できるコンテキスト ファイルも含まれています。
  • API リファレンス: REST リファレンス ドキュメント。