デベロッパー チェックリスト

このチェックリストでは、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 を使用する: サブスクリプション API を使用して、 ポーリングではなくリアルタイム通知を受信します。受信した 通知をキューに入れ、個別に処理します。webhook のベスト プラクティスをご覧ください。

4. 本公開の準備を整える

OAuth の検証: アプリで 100 人を超えるユーザーをサポートする必要がある場合、または 一般公開する準備ができたら、OAuth の検証のためにアプリを送信します。この プロセスには数日かかり、サードパーティのセキュリティ レビュー と、アプリのプライバシー ポリシーと利用規約の検証が含まれます。

Fitbit Web API の移行: 移行する場合は、移行ガイドの推奨事項に沿って、ユーザーを移行するための再認証フローがスムーズに行われるようにします。

5. リリースとメンテナンス

アプリを公開する: OAuth の検証が完了したら、Google Cloud コンソールでアプリを「本番環境」に公開して、100 ユーザーの制限を解除します。

モニタリング: Google Cloud コンソールで API の使用状況とエラー率をモニタリングします。

最新情報を入手する: API の更新とサポート終了については、リリースノートをご確認ください。