このガイドでは、Google Health API の使用時に発生する一般的な問題のトラブルシューティング方法について説明します。
4xx クライアント エラー
クライアント アプリのコードに問題がある場合は、4xx ステータス コードが返されます。問題の詳細については、レスポンス本文の要素をご覧ください。
400 不正なリクエスト
| メッセージ | 説明 | 推奨事項 |
|---|---|---|
| リクエストに無効な引数が含まれています。 | データ型 ID {value} はサポートされていません。 | 参照されているデータ型がエンドポイントでサポートされていることを確認します。 |
| 無効な JSON ペイロードを受信しました。8 進数と 16 進数は有効な JSON 値ではありません。 | dailyRollUp エンドポイントは、それぞれ MM または DD で表される月と日の値をサポートしていません。1 桁の数字の先頭に 0 を付けないでください。 |
|
| リソース名に無効なプロジェクト番号が含まれています | リクエスト URL でプロジェクト番号の代わりに Google Cloud プロジェクト ID を使用してサブスクライバーを削除または更新する場合。これは、projects.subscribers エンドポイントを使用する Webhook サブスクリプションに適用されます。 |
リクエスト URL には、プロジェクト ID ではなく Google Cloud プロジェクト番号を使用します。 |
401 Unauthorized（未承認）
| メッセージ | 説明 | 推奨事項 |
|---|---|---|
| リクエストに無効な認証情報があります。OAuth 2 アクセス トークン、ログイン Cookie などの有効な認証情報が必要です。 | INVALID_AUTHENTICATOR: トークンの有効期限切れ | アクセス トークンの有効期限が切れています。更新トークンを使用して新しいアクセス トークンと更新トークンを取得するか、ユーザーがアプリケーションに再度同意する必要があります。 |
403 Forbidden（アクセス拒否）
| メッセージ | 説明 | 推奨事項 |
|---|---|---|
| The caller does not have permission | リクエスト URL でプロジェクト番号の代わりに Google Cloud プロジェクト ID を使用してサブスクライバーを作成または一覧表示する場合。これは、projects.subscribers エンドポイントを使用する Webhook サブスクリプションに適用されます。 |
リクエスト URL には、プロジェクト ID ではなく Google Cloud プロジェクト番号を使用します。 |
| 呼び出し元に権限がない。 | GaiaMint から UberMint を作成できませんでした。 | ユーザーは認証フローを完了できましたが、エンドポイント呼び出しに失敗しました。これは、以前の Fitbit アカウントが Google アカウントではなくアプリに同意した場合に発生することがあります。このエラーを解決する方法は以下のとおりです。
|
404 見つかりません
| メッセージ | 説明 | 推奨事項 |
|---|---|---|
リクエストされた URL ( /v4/users/me/dataTypes/{dataType}/dataPoints) はこのサーバーに見つかりませんでした。 |
考えられる原因:
|
Fitbit ユーザー ID を取得する
お客様の問題のトラブルシューティングを行うには、Fitbit モバイルアプリにログインしているお客様の Google アカウントを確認する必要がある場合があります。
Fitbit ユーザー ID を確認する手順は次のとおりです。
- Fitbit モバイルアプリを開きます。
- 右下の [マイページ] アイコンを押します。
- ユーザー名と参加日が表示されている上部のタイルにある [プロフィールを編集] リンクを押します。
- ライトモードの場合、[Your account] セクションで、ID に割り当てられている値は Fitbit ユーザー ID です。（例: CV5TKH）
アプリへの同意を取り消す
アプリへの OAuth2 接続に関するユーザーのトラブルシューティングをサポートする際に、ユーザーにアプリからアカウントのリンクを解除し、認証フローを再度完了していただく必要がある場合があります。
アプリから Google アカウントのリンクを解除するには:
- Fitbit モバイルアプリを開きます。
- 右上にある Fitbit ユーザー プロフィール アイコンを押します。
- [Google アカウントを管理] を押します。
- [データとプライバシー] タイルを選択します。
- [**ご利用のアプリ、サービスのデータ] セクションまでスクロールします。[アプリとサービス] で [サードパーティ製のアプリとサービス] を選択します。
- 接続されているアプリのリストでアプリ名を探し、ユーザーに選択してもらいます。
- [<アプリ名> との接続をすべて削除しますか？] を押します。
- [確認] を押して、アプリへの同意を取り消すようユーザーに伝えます。
取り消しプロセスが完了すると、ユーザーは [サードパーティ製アプリとサービス] ページのリストに戻ります。リストからアプリ名が削除されたことを確認するには、ページを更新する必要がある場合があります。