エラーケース

以降のセクションでは、モバイル データプラン共有 API が呼び出し元にエラーを返す最も一般的なシナリオについて説明します。エラーが解決しない場合は、[e-mail] にお問い合わせください。リクエスト本文とともに呼び出される URL を共有してください。

HTTP 404 Not Found

HTTP 404 エラーの最も一般的な理由は、通知を送信するユーザーの GCM トークンを GTAF が見つけられないことです。これは、デバイスが CPID と関連する GCM トークンを GTAF に登録する機会を得られなかったか、登録に失敗した場合に発生します。デバイスが GTAF の事前リリース版インスタンスに登録されていて、通知が GTAF のリリース版インスタンスに送信されている場合にも、この問題が発生する可能性があります。

このエラーを診断するには:

1. デバイスで MDP UI が正常に読み込まれていることを確認します。
2. 呼び出しのパス パラメータとクエリ パラメータが URL エンコードされていることを確認します。
3. 事前リリース版（preprod-mobiledataplansharing.googleapis.com）と本番環境版（mobiledataplansharing.googleapis.com）の両方のエンドポイントを試してください。

HTTP 400 Bad Request

このエラーは、GTAF に送信されたリクエストの本文が無効な場合に発生します。この場合の最も一般的なシナリオは次のとおりです。

1. PlanStatus の updateTime が指定されていないか、将来の日付になっています。
2. PlanStatus の expireTime が指定されていないか、過去の日付になっています。
3. userKey クエリ パラメータがありません。
4. 通知の作成に必要なすべてのフィールドが存在しない。通知をトリガーする方法について詳しくは、通知のガイドラインをご覧ください。

HTTP 409 競合

GTAF は、キャッシュ内の PlanStatus がリクエストで送信されたものよりも新しい（つまり、updateTime が新しい）場合、このエラーを呼び出し元に返します。ログを確認して、このユーザーに PlanStatus がプッシュされているかどうかを確認してください。

HTTP 403 Forbidden

URL で使用されている特定の ASN に対して Mobile Data Plan Sharing API を呼び出す権限が呼び出し元にない場合、GTAF はこのエラーを返します。このエラーを診断するには:

1. Google Cloud コンソールの API ライブラリで API が有効になっていることを確認します。
2. 呼び出しに使用されているサービス アカウントが、携帯通信会社の ISP ポータルに追加されている。