標準エラー メッセージ
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
このドキュメントでは、Google API から返されるエラーコードとメッセージの一部を紹介します。具体的に、ここに記載されているエラーは、Google API のグローバル、つまりデフォルトのドメインに含まれます。多くの API では、グローバル ドメインに含まれない API 固有のエラーを特定する、独自のドメインも定義されています。これらのエラーでは、JSON レスポンスの domain プロパティの値は、youtube.parameter のような API 固有の値になります。
このページでは、RFC 7231 で定義されている HTTP ステータス コード別にエラーを一覧表示します。
次の JSON レスポンスのサンプルは、グローバル エラーの通信方法を示しています。
{
"error": {
"errors": [
{
"domain": "global",
"reason": "invalidParameter",
"message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
"locationType": "parameter",
"location": "chart"
}
],
"code": 400,
"message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
}
}
エラー
- MOVED_PERMANENTLY (301)
- SEE_OTHER (303)
- NOT_MODIFIED (304)
- TEMPORARY_REDIRECT (307)
- BAD_REQUEST (400)
- UNAUTHORIZED (401)
- PAYMENT_REQUIRED (402)
- FORBIDDEN (403)
- NOT_FOUND (404)
- METHOD_NOT_ALLOWED (405)
- CONFLICT (409)
- GONE (410)
- PRECONDITION_FAILED (412)
- REQUEST_ENTITY_TOO_LARGE (413)
- REQUESTED_RANGE_NOT_SATISFIABLE (416)
- EXPECTATION_FAILED (417)
- PRECONDITION_REQUIRED (428)
- TOO_MANY_REQUESTS (429)
- INTERNAL_SERVER_ERROR (500)
- NOT_IMPLEMENTED (501)
- SERVICE_UNAVAILABLE (503)
MOVED_PERMANENTLY (301)
| エラーコード |
説明 |
movedPermanently |
このリクエストと、同じ操作に対する後続のリクエストは、リクエストの送信先の URL ではなく、このレスポンスの Location ヘッダーで指定された URL に送信する必要があります。 |
SEE_OTHER (303)
| エラーコード |
説明 |
seeOther |
リクエストは正常に処理されました。レスポンスを取得するには、Location ヘッダーで指定された URL に GET リクエストを送信します。 |
mediaDownloadRedirect |
リクエストは正常に処理されました。レスポンスを取得するには、Location ヘッダーで指定された URL に GET リクエストを送信します。 |
NOT_MODIFIED (304)
| エラーコード |
説明 |
notModified |
If-None-Match ヘッダーに設定された条件が満たされていません。このレスポンスは、リクエストされたドキュメントが更新されていないため、キャッシュに保存されたレスポンスを取得する必要があることを示します。If-None-Match HTTP リクエスト ヘッダーの値を確認してください。 |
TEMPORARY_REDIRECT (307)
| エラーコード |
説明 |
temporaryRedirect |
リクエストの処理を完了するには、このレスポンスの Location ヘッダーで指定された URL にリクエストを再送信してください。 |
BAD_REQUEST (400)
| エラーコード |
説明 |
badRequest |
API リクエストが無効であるか、形式が正しくありません。そのため、API サーバーはリクエストを認識できませんでした。 |
badBinaryDomainRequest |
バイナリ ドメイン リクエストが無効です。 |
badContent |
リクエスト データのコンテンツ タイプ、またはマルチパート リクエストの一部のコンテンツ タイプがサポートされていません。 |
badLockedDomainRequest |
ロックされたドメインのリクエストが無効です。 |
corsRequestWithXOrigin |
CORS リクエストに、不正な CORS リクエストを示す XD3 X-Origin ヘッダーが含まれています。 |
endpointConstraintMismatch |
指定された API と一致しないため、リクエストは失敗しました。URL パスの値が正しいことを確認してください。 |
invalid |
無効な値が含まれているため、リクエストを処理できませんでした。無効な値は、パラメータ値、ヘッダー値、プロパティ値のいずれかです。 |
invalidAltValue |
alt パラメータの値が不明な出力形式を指定しています。 |
invalidParameter |
無効なパラメータまたはパラメータ値が含まれていたため、リクエストを処理できませんでした。API ドキュメントを確認し、リクエストに対して有効なパラメータを調べてください。 |
invalidQuery |
リクエストが無効です。API ドキュメントを確認してリクエストに対応しているパラメータを判別し、リクエストに対して無効なパラメータの組み合わせや、無効なパラメータ値が含まれていないか確認してください。q リクエスト パラメータの値を確認してください。 |
keyExpired |
リクエストで指定された API キーの期限が切れています。つまり、API サーバーが、リクエストを行っているアプリケーションの割り当て上限を確認できません。詳細を確認する、または新しいキーを取得する方法については、Google Developers Console をご覧ください。 |
keyInvalid |
リクエストで指定された API キーが無効です。つまり、API サーバーはリクエストを行っているアプリケーションの割り当て上限を確認できません。API キーの確認や取得には、Google Developers Console をご利用ください。 |
lockedDomainCreationFailure |
クエリ文字列で OAuth トークンを受信しましたが、この API では JSON または XML 以外のレスポンス形式ではこれを禁止しています。可能であれば、代わりに Authorization ヘッダーで OAuth トークンを送信してみてください。 |
notDownload |
/download/* URL パスに送信できるのは、メディア ダウンロードのリクエストのみです。/download プレフィックスを付けずに、同じパスにリクエストを再送信してください。 |
notUpload |
アップロード リクエストではないため、リクエストは失敗しました。/upload/* URI に送信できるのはアップロード リクエストのみです。/upload 接頭辞を付けずに、同じパスにリクエストを再送信してみてください。 |
parseError |
API サーバーがリクエストの本文を解析できません。 |
required |
API リクエストに必要な情報がありません。パラメータまたはリソース プロパティの情報が欠けている可能性があります。 |
tooManyParts |
含まれているパーツが多すぎるため、マルチパート リクエストを処理できませんでした。 |
unknownApi |
リクエストが呼び出している API を認識できません。 |
unsupportedMediaProtocol |
クライアントが、サポートされていないメディア プロトコルを使用しています。 |
unsupportedOutputFormat |
alt パラメータ値で、このサービスでサポートされていない出力形式が指定されています。alt リクエスト パラメータの値を確認してください。 |
wrongUrlForUpload |
リクエストはアップロード リクエストですが、正しい URI に送信されなかったため処理できませんでした。アップロード リクエストは、/upload/* プレフィックスを含む URI に送信する必要があります。/upload プレフィックスを含めた状態で、もう一度同じパスにリクエストを送信してください。 |
UNAUTHORIZED (401)
| エラーコード |
説明 |
unauthorized |
リクエストの実行がユーザーに許可されていません。 |
authError |
リクエストに入力された認証情報が無効です。Authorization HTTP リクエスト ヘッダーの値を確認してください。 |
expired |
セッションの有効期限が切れています。Authorization HTTP リクエスト ヘッダーの値を確認してください。 |
lockedDomainExpired |
前回有効だったロックされたドメインの有効期限が切れているため、リクエストを処理できませんでした。 |
required |
この API リクエストを行うには、ユーザーがログインする必要があります。Authorization HTTP リクエスト ヘッダーの値を確認してください。 |
PAYMENT_REQUIRED (402)
| エラーコード |
説明 |
dailyLimitExceeded402 |
デベロッパーによって設定された 1 日の予算上限に達しました。 |
quotaExceeded402 |
リクエストされたオペレーションには、割り当てを超えるリソースが必要です。オペレーションを完了するには、お支払いが必要です。 |
user402 |
リクエストされたオペレーションには、認証済みユーザーによるお支払いが必要です。 |
FORBIDDEN (403)
| エラーコード |
説明 |
forbidden |
リクエストされたオペレーションは禁止されているため、完了できません。 |
accessNotConfigured |
お使いのプロジェクトは、この API にアクセスできないよう構成されています。Google Developers Console を使用して、プロジェクトの API を有効にしてください。 |
accessNotConfigured |
不正があったため、プロジェクトがブロックされています。http://support.google.com/code/go/developer_compliance をご覧ください。 |
accessNotConfigured |
プロジェクトが削除対象としてマークされています。 |
accountDeleted |
リクエストの認証情報に関連付けられているユーザー アカウントが削除されています。Authorization HTTP リクエスト ヘッダーの値を確認してください。 |
accountDisabled |
リクエストの認証情報に関連付けられているユーザー アカウントが無効になっています。Authorization HTTP リクエスト ヘッダーの値を確認してください。 |
accountUnverified |
リクエストを実行しているユーザーのメールアドレスが確認されていません。Authorization HTTP リクエスト ヘッダーの値を確認してください。 |
concurrentLimitExceeded |
同時実行の使用量上限に達したため、リクエストを処理できませんでした。 |
dailyLimitExceeded |
API の 1 日の割り当て上限に達しました。 |
dailyLimitExceeded |
1 日の割り当て上限に到達し、また不正があったためプロジェクトがブロックされました。この問題を解決するには、Google API のコンプライアンス サポート フォームを参照してください。 |
dailyLimitExceededUnreg |
未認証の API の 1 日あたりの利用制限に到達したため、リクエストを処理できませんでした。API の利用を続けるには、Google 開発用コンソールに登録する必要があります。 |
downloadServiceForbidden |
API がダウンロード サービスをサポートしていません。 |
insufficientAudience |
このオーディエンスに対するリクエストは完了できません。 |
insufficientAuthorizedParty |
このアプリケーションに対するリクエストは完了できません。 |
insufficientPermissions |
認証済みユーザーに、このリクエストの実行に必要な権限がありません。 |
limitExceeded |
アクセスまたは速度制限により、リクエストを完了できません。 |
lockedDomainForbidden |
この API は、ロックされたドメインをサポートしていません。 |
quotaExceeded |
リクエストされたオペレーションには、割り当てを超えるリソースが必要です。 |
rateLimitExceeded |
一定時間に送信されたリクエスト数が多すぎます。 |
rateLimitExceededUnreg |
レート制限を超えているため、API の呼び出しを継続するにはアプリケーションを登録する必要があります。Google Developers Console を使用してご登録ください。 |
responseTooLarge |
リスエストされたリソースが大きすぎて返せません。 |
servingLimitExceeded |
API に対して指定された全体の速度制限にすでに達しています。 |
sslRequired |
このオペレーションを行うには、SSL が必要です。 |
unknownAuth |
API サーバーが、リクエストに使用される認証スキームを認識しません。Authorization HTTP リクエスト ヘッダーの値を確認してください。 |
userRateLimitExceeded |
ユーザーごとのレート制限に到達したため、リクエストを処理できませんでした。 |
userRateLimitExceededUnreg |
ユーザーごとのレート制限に達していますが、クライアント デベロッパーがリクエストで特定されなかったため、リクエストは失敗しました。Google Developer Console（https://console.developers.google.com）を使用して、アプリケーションのプロジェクトを作成してください。 |
variableTermExpiredDailyExceeded |
可変期間の割り当てが期限切れで、1 日の上限に達したため、リクエストを処理できませんでした。 |
variableTermLimitExceeded |
可変期間割り当ての上限に達したため、リクエストを処理できませんでした。 |
NOT_FOUND (404)
| エラーコード |
説明 |
notFound |
リクエストに関連付けられたリソースが見つからなかったため、リクエストされたオペレーションに失敗しました。 |
notFound |
リクエストに関連付けられたリソースが見つかりませんでした。過去 2 週間にこの API を使用していない場合、App Engine を再デプロイし、もう一度呼び出しを行ってください。 |
unsupportedProtocol |
リクエストで使用されているプロトコルがサポートされていません。 |
METHOD_NOT_ALLOWED (405)
| エラーコード |
説明 |
httpMethodNotAllowed |
リクエストに関連付けられている HTTP メソッドがサポートされていません。 |
CONFLICT (409)
| エラーコード |
説明 |
conflict |
リクエストされたオペレーションが既存のアイテムと競合するため、API リクエストを完了できません。多くの場合、重複するアイテムはより具体的なエラーによって特定されますが、重複アイテムを作成しようとするリクエストは競合状態を生み出します。 |
duplicate |
リクエストされたオペレーションがすでに存在するリソースを作成しようとしたため、リクエストの処理ができませんでした。 |
GONE (410)
| エラーコード |
説明 |
deleted |
リクエストに関連付けられたリソースが削除されているため、リクエストを処理できませんでした。 |
PRECONDITION_FAILED (412)
| エラーコード |
説明 |
conditionNotMet |
リクエストの If-Match または If-None-Match HTTP リクエスト ヘッダーで設定された条件が満たされていません。詳細については、HTTP 仕様の ETag セクションをご覧ください。If-Match HTTP リクエスト ヘッダーの値を確認してください。 |
REQUEST_ENTITY_TOO_LARGE (413)
| エラーコード |
説明 |
backendRequestTooLarge |
リクエストが大きすぎます。 |
batchSizeTooLarge |
バッチ リクエストに含まれる要素が多すぎます。 |
uploadTooLarge |
リクエストで送信されたデータが大きすぎるため、リクエストを処理できませんでした。 |
REQUESTED_RANGE_NOT_SATISFIABLE (416)
| エラーコード |
説明 |
requestedRangeNotSatisfiable |
リクエストで指定された範囲を満たせません。 |
EXPECTATION_FAILED (417)
| エラーコード |
説明 |
expectationFailed |
サーバーが、クライアントの期待値を満たすことができません。 |
PRECONDITION_REQUIRED (428)
| エラーコード |
説明 |
preconditionRequired |
リクエストが、提供されていない前提条件を必要としています。このリクエストを成功させるには、リクエストに If-Match または If-None-Match のどちらかのヘッダーを指定する必要があります。 |
TOO_MANY_REQUESTS (429)
| エラーコード |
説明 |
rateLimitExceeded |
一定時間に送信されたリクエスト数が多すぎます。 |
INTERNAL_SERVER_ERROR (500)
| エラーコード |
説明 |
internalError |
内部エラーのためリクエストを処理できませんでした。 |
NOT_IMPLEMENTED (501)
| エラーコード |
説明 |
notImplemented |
リクエストされたオペレーションは実装されていません。 |
unsupportedMethod |
リクエストが不明なメソッドまたはオペレーションを実行しようとしたため、リクエストを処理できませんでした。 |
SERVICE_UNAVAILABLE (503)
| エラーコード |
説明 |
backendError |
バックエンド エラーが発生しました。 |
backendNotConnected |
接続エラーによりリクエストを処理できませんでした。 |
notReady |
API サーバーがリクエストを受け取る準備ができていません。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-07-23 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2024-07-23 UTC。"],[[["This document provides a comprehensive list of Google API error codes and their corresponding descriptions, categorized by HTTP status codes (3xx, 4xx, 5xx)."],["Errors are structured in JSON format, containing details like domain, reason, message, location, and HTTP code."],["Common client errors (4xx) include bad requests, unauthorized access, forbidden requests, and resource not found errors, each with specific reason codes."],["Server errors (5xx) indicate issues on Google's end, such as internal server errors or service unavailability."],["Each error code has a detailed description to help developers understand and troubleshoot issues encountered while using Google APIs."]]],[]]
