トラブルシューティング

このガイドでは、Google Health API の使用時に発生する一般的な問題のトラブルシューティング方法について説明します。

4xx クライアント エラー

クライアント アプリのコードに問題がある場合は、4xx ステータス コードが返されます。問題の詳細については、レスポンス本文の要素をご覧ください。

400 不正なリクエスト

メッセージ 説明 推奨事項
リクエストに無効な引数が含まれています。 データ型 ID {value} はサポートされていません。 参照されているデータ型がエンドポイントでサポートされていることを確認します。
無効な JSON ペイロードを受信しました。8 進数または 16 進数は有効な JSON 値ではありません。 dailyRollUp エンドポイントでは、月と日が MM または DD で表される値はサポートされていません。1 桁の数字の先頭に 0(ゼロ)を付けることはできません。

401 Unauthorized(未承認)

メッセージ 説明 推奨事項
リクエストに無効な認証情報があります。OAuth 2 アクセス トークン、ログイン Cookie などの有効な認証情報が必要です。 INVALID_AUTHENTICATOR: トークンの有効期限が切れています アクセス トークンの有効期限が切れています。更新トークンを使用して新しいアクセス トークンと更新トークンを取得するか、ユーザーにアプリケーションへの再同意を求めます。

403 Forbidden(アクセス拒否)

メッセージ 説明 推奨事項
呼び出し元に権限がない。 GaiaMint から UberMint を作成できませんでした。 ユーザーは承認フローを完了できましたが、 エンドポイントの呼び出しに失敗しました。これは、Google アカウントではなく、従来の Fitbit アカウントがアプリに同意した場合に発生することがあります。このエラーを解決するには:
  1. Fitbit の設定から Fitbit モバイルアプリをログアウトします。
  2. [Google で続行] または [Google でログイン] ボタンを押して、Fitbit モバイルアプリにログインします。「この Google アカウントで Fitbit を使用できません」というメッセージが表示された場合は、メールアドレスが従来の Fitbit アカウントとして登録されています。この ヘルプ記事 の手順に沿ってアカウントを移行してください。
  3. 新しい Google アカウントで Fitbit モバイルアプリに正常にログインできたら、同じメールアドレスを使用して再度同意してみてください。

404 見つかりません

メッセージ 説明 推奨事項
リクエストされた URL /v4/users/me/dataTypes/{dataType}/dataPoints はこのサーバー上に見つかりませんでした。 考えられる原因:
  • 正しい動詞が使用されていることを確認する
  • エンドポイントの構文に誤字脱字がないか確認する

Fitbit ユーザー ID を取得する

ユーザーの問題のトラブルシューティングを行うには、Fitbit モバイルアプリにログインしているユーザーの Google アカウントを確認する必要がある場合があります。

Fitbit ユーザー ID を確認する手順は次のとおりです。

  1. Fitbit モバイルアプリを開きます。
  2. 右下の [ユーザー] アイコンを押します。
  3. ユーザー名と登録日を含む上部のタイルにある [プロフィールを編集] リンクを押します。
  4. ページの一番下まで移動します。[**アカウント**] セクションで、ID に割り当てられている値が Fitbit ユーザー ID です。(例: CV5TKH)

ユーザーがアプリへの OAuth2 接続のトラブルシューティングを行っている場合は、アプリからアカウントのリンクを解除し、承認フローを再度完了する必要がある場合があります。

Google アカウントとアプリのリンクを解除する手順は次のとおりです。

  1. Fitbit モバイルアプリを開きます。
  2. 右上にある Fitbit ユーザー プロフィール アイコンを押します。
  3. [Google アカウントを管理] を押します。
  4. [データとプライバシー] タイルを選択します。
  5. [**ご利用のアプリ、サービスのデータ**] セクションまでスクロールします。 [アプリとサービス] で [サードパーティのアプリとサービス] を選択します。
  6. 接続されているアプリのリストでアプリ名を探し、選択してもらいます。
  7. [<アプリ名> との接続をすべて削除] を押します。
  8. 確認を押して、アプリへの同意を取り消してもらいます。

取り消しプロセスが完了すると、[サードパーティのアプリとサービス] ページに戻ります。リストからアプリ名が削除されたことを確認するには、ページの更新が必要になる場合があります。