主要なエラー

このドキュメントでは、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 Developers Console で登録する必要があります。
`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 サーバーはリクエストを受け取る準備が整っていません。