Google Civic Information API の v2 のエラーは、HTTP ステータス コードにマッピングされています。次の表に、各エラーとその説明を示します。各エラー レスポンスには、エラーの reason 要素が含まれます。場合によっては、同様のエラーが同じ HTTP ステータス コードおよび同じ reason 要素にマッピングされることがあります。これらのケースは、デバッグのために message 要素によってさらに区別できます。エラー レスポンスの message 要素を調べるコードは作成しないことをおすすめします。
API から標準の Google API エラーが返されることもあります。エラーの説明は、標準エラーページで確認できます。
今後、エラーが追加される可能性があります。新しいエラーは API フォーラムに発表されます。
エラー表
reason |
HTTP ステータス コード | message |
説明 |
|---|---|---|---|
parseError |
400 |
住所を解析できませんでした | API に送信された住所を解析できませんでした。これは、アドレスが完全に指定されていない場合に発生します。 |
required |
400 |
住所が指定されていません | このリクエストには住所を指定する必要があります。 |
invalidValue |
400 |
不明な選挙 | リクエストされた選挙は不明です。リクエストされた選挙 ID が無効である可能性があります。指定された住所で使用可能なデータがない場合、選挙 ID が指定されていないリクエストでも発生することがあります。 |
invalidQuery |
400 |
選挙は終了しました | リクエストされた選挙は終了しました。この選挙に関するデータは利用できなくなりました。 |
unauthorized |
401 |
リクエストが適切に承認されませんでした。 | |
limitExceeded |
403 |
取得した OCD ID が多すぎます | 再帰的なリクエストで処理した部門が多すぎます。追加のフィルタを適用するか、制約の厳しい OCD ID を使用してください。場合によっては、返された非再帰ルックアップの後に、返されたより小さな区分に対して複数の再帰ルックアップを行う必要があります。 |
notFound |
404 |
この住所の情報はありません | API は、この住所に関する情報を持っていません。その住所が米国の居住地住所ではないことが原因である可能性があります。このエラーのもう 1 つの理由は、この住所の選挙データがない場合です。 |
conflict |
409 |
この住所の情報が競合しています | この住所で競合する情報が見つかりました。現在使用されていません。 |
backendError |
503 |
API でリクエストへの応答で問題が発生しました。このタイプのエラーは再試行できます。 |