Google API - グローバル ドメインエラー

このドキュメントでは、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]"
 }
}

エラー

  1. MOVED_PERMANENTLY (301)
  2. SEE_OTHER (303)
  3. NOT_MODIFIED (304)
  4. TEMPORARY_REDIRECT (307)
  5. BAD_REQUEST (400)
  6. UNAUTHORIZED (401)
  7. PAYMENT_REQUIRED (402)
  8. FORBIDDEN (403)
  9. NOT_FOUND (404)
  10. METHOD_NOT_ALLOWED (405)
  11. CONFLICT (409)
  12. GONE (410)
  13. PRECONDITION_FAILED (412)
  14. REQUEST_ENTITY_TOO_LARGE (413)
  15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
  16. EXPECTATION_FAILED (417)
  17. PRECONDITION_REQUIRED (428)
  18. TOO_MANY_REQUESTS (429)
  19. INTERNAL_SERVER_ERROR (500)
  20. NOT_IMPLEMENTED (501)
  21. 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 パラメータの値が不明な出力形式を指定しています。
invalidHeader 無効なヘッダーが含まれていたため、リクエストを処理できませんでした。
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 サーバーがリクエストを受け取る準備ができていません。