Google Health API について

Fitbit Web API は、デベロッパーの統合に、より標準化され、一貫性があり、スケーラブルな基盤を提供するために改善され、最新化されました。現在は Google Health API と呼ばれています。Google Health API は、以前の Fitbit Web API の戦略的な進化を表しており、Google の最新のインフラストラクチャでゼロから再構築されています。

このプラットフォームにより、デベロッパーは Google Cloud デベロッパー ツールのすべての機能にアクセスできるようになります。また、ユーザーは Google OAuth 2.0 を通じて、使い慣れた効率的な方法で権限を管理できるようになります。

Google Health API でできること

  • 信頼できる一元的な情報源: 新しい「調整済みストリーム」は、複数のソースから重複するデータポイントを調整するという複雑なタスクを処理します。これにより、Fitbit アプリ内でユーザーに表示されるのと同じ一貫したデータがアプリに表示されます。このストリームは、Fitbit デバイスと Google Pixel デバイスのデータ、および手動入力を含むファースト パーティ ストリームに加えて提供されます。
  • 技術のモダナイゼーションとパフォーマンス: 100 を超えるレガシー エンドポイントを、簡素化されたデータタイプ バンドルの合理化されたセットに統合し、データ形式、タイムゾーン、測定単位、エラー処理の不整合を解消しました。さらに、高パフォーマンスのデータ取得のために HTTP/REST プロトコルがサポートされるようになりました。また、専用のリスト エンドポイントを介して、関連するすべてのデータタイプでイントラデイ データと Webhook を利用できるようになりました。
  • 強化された Webhook とスケーラビリティ: 自動サブスクリプションや、関連するすべてのデータタイプの詳細な管理など、Webhook のサポートが拡張され、次世代の AI 駆動型健康アプリに合わせてスケーリングできるようになりました。
  • ID とセキュリティの合理化: 以前の Fitbit 認証(FOT)を Google OAuth 2.0 に置き換えます。これにより、デベロッパーは標準の Google 認証ライブラリを利用して、コードベースを簡素化しながら、ユーザーに権限を管理するための使い慣れた一元化された方法を提供できます。すべての Google Health API スコープは制限付きに分類され、アクセスにはプライバシーとセキュリティの審査が必要です。

アセットが気に入った場合、今すぐ使ってみる

API バージョンと公開ベータ版チャンネル

Google Health API は、Google の API 改善提案(AIP)、具体的には AIP-185: API バージョニングと AIP-181: 安定性レベルに従って、チャネルベースのバージョニングを使用します。この API は、安定版の v4 チャンネルと公開ベータ版の v4beta チャンネルの 2 つの公開チャンネルで利用できます。Google は、標準のサポート チャネルを通じて両方のチャネルをサポートしています。

Stable チャンネルと Beta チャンネルを比較する

AIP-185 に従って、v4beta チャンネルは安定版の v4 チャンネルのスーパーセットとして機能します。これには、すべての安定版 v4 機能に加えて、パートナー テスト中の早期アクセス データタイプ、フィールド、メソッドが含まれます。

ドキュメントでは、Beta チャンネルでのみ使用できる API 要素に v4beta ラベルが表示されます。

機能 Stable チャンネル(v4) 公開ベータ版チャンネル(v4beta)
REST ベース URI https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
gRPC パッケージ google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
リファレンス ドキュメント v4 REST と v4 RPC v4beta REST と v4beta RPC
安定性レベル プロダクション レディであり、AIP-180 の下位互換性ルールに則っています。 不安定なプレビュー。互換性のない変更や削除が予告なく行われる可能性があります。
Intended use 稼働中のユーザー向け本番環境アプリケーション。 初期テスト、プロトタイピング、スキーマ検証、デベロッパーからのフィードバック。
サポート 標準のサポート チャネルでサポートされています。 バグレポート、トラブルシューティング、設計に関するフィードバックについては、標準のサポート チャネルを通じてサポートされます。

v4beta チャンネルの扱い

v4beta のタグが付いた機能を調べる場合は、次のガイドラインに沿って行ってください。

  • v4beta は、主に開発環境、ステージング環境、非本番環境のテスト環境で使用します。v4beta エンドポイントまたはベータ版のみのデータ型に依存する本番環境機能をリリースすることはおすすめしません。
  • v4beta のスキーマ、フィールド名、エンドポイントの動作、データ表現は、予告なく変更される可能性があります。ベータ版の機能とデータ型は、検証目標を達成できない場合、完全に削除されることもあります。
  • 試験運用版の v4beta クライアント コードをフィーチャー トグルまたは別のモジュールの背後に分離して、Beta チャンネルの互換性を破る変更がコア v4 統合を中断しないようにします。
  • v4beta のサポートを受けたり、問題を報告したり、実装に関するフィードバックを共有したりするには、標準のサポート チャネルをご利用ください。最終的な API 設計の参考にさせていただきます。

v4beta から安定版 v4 への昇格

新しいデータ型と機能は、パートナーによるテストと市場検証をサポートするために v4beta に追加され、その後、安定版の v4 チャンネルに移行します。

Google は、ベータ版の機能を v4 に昇格させる前に、次の基準に照らして評価します。

  • パートナー テストでは、データモデル、フィールド セマンティクス、クエリパターンが実際のアプリケーション要件を満たしていることを確認します。
  • デベロッパーのフィードバックと設計レビューが完了し、AIP-180 の下位互換性の保証に基づいてスキーマをロックする準備が整いました。
  • エンドツーエンドのデータ パイプライン、デバイスの同期、サービスの信頼性が、本番環境の品質基準を満たしている。
  • AIP-185 の非推奨ルールに沿って、ベータ版テスト中に非推奨となったフィールドや動作は、v4 にプロモートされるのではなく、削除されます。

AIP-181 では、ベータ版の評価期間として約 90 日という一般的な目安が示されていますが、機能を v4beta から v4 に移行する実際のタイミングは、機能の複雑さ、ハードウェアの可用性、検証フィードバックによって異なります。一部の機能は早期に正式リリースされる可能性がありますが、他の機能は v4beta に長期間留まるか、廃止される可能性があります。

データ型または機能が安定版の v4 チャンネルに昇格すると、Google はリリースノートで卒業を発表します。その時点で、統合を本番環境のユーザーにリリースする前に、リクエストを https://health.googleapis.com/v4beta から https://health.googleapis.com/v4 に更新します。

Fitbit Web API はどうなりますか?

以前の Fitbit Web API は、次のスケジュールに沿って廃止されました。

  • 2026 年 9 月 30 日(サポート終了): Fitbit Web API のサポートが終了し、Google はバグの修正や API サポートの提供を停止しました。
  • 2026 年 11 月 2 日(API の無効化): Fitbit Web API と Fitbit OAuth エンドポイントが無効になり、機能しなくなりました。また、Google Health ユーザーとのデータの同期も行われなくなりました。これらのエンドポイントへのリクエストは失敗し、HTTP 410 Gone ステータス コードが返されます。

以前の Fitbit Web API と Fitbit 認証を使用しているデベロッパーは、アプリケーションとユーザーを Google Health API と Google OAuth 2.0 に移行する必要があります。

詳しくは、移行ガイドをご覧ください。

対応しているデバイスを教えてください。

現在および以前のすべての Fitbit デバイスと Google Pixel Watch は、Google Health API を通じて返されるデータを収集します。利用可能なデータの種類は、デバイスがサポートする機能によって異なります。

現在のデバイスのリストは、Google ストアで確認できます。

フィードバックを送るにはどうすればよいですか?

皆様のフィードバックは大変貴重です。サポートページに記載されているサポート チャネルを通じて、ご意見をお聞かせください。

これらの API が適切にサポートされるよう、Google は多大な努力を払ってきましたが、Google Health API は現在も進化を続けています。なお、皆様からのフィードバックに基づいて、5 月末までに変更が導入される可能性があります。その場合は、お客様側でも対応する更新が必要になります。

ロードマップ

2026 年にリリース予定の機能の一覧です。

2026 年第 4 四半期

データ型(読み取りと書き込み)

  • 詳細な皮膚温
  • 基礎代謝率
  • ヘルスコネクトと同等になるよう、データタイプを追加する予定です。2026 年第 4 四半期と 2027 年第 1 四半期には、さらに多くのヘルスコネクトのデータ型が追加される予定です。

機能

  • 新しいデータ型に早期アクセスできる公開ベータ版チャンネル
  • Webhook テレメトリーをモニタリングする統計情報エンドポイント