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

このチェックリストでは、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 の更新とサポート終了については、リリースノートで最新情報を確認してください。