このページは Cloud Translation API によって翻訳されました。

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]"
 }
}

エラー

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 サーバーがリクエストを受け取る準備ができていません。

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

エラー