Mensagens de erro

Este documento identifica alguns códigos e mensagens de erros retornados pelas APIs do Google. Especificamente, os erros listados aqui estão no domínio global ou padrão das APIs do Google. Muitas APIs também definem os próprios domínios, que identificam erros específicos da API que não estão no domínio global. Para esses erros, o valor da propriedade domain na resposta JSON será um valor específico da API, como youtube.parameter.

Esta página lista erros por códigos de status HTTP conforme definidos em RFC 7231.

A amostra de resposta JSON abaixo demonstra como um erro global é comunicado:

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

Erros

MOVED_PERMANENTLY (301)

Código do erro	Descrição
`movedPermanently`	Esta e futuras solicitações para a mesma operação precisam ser enviadas ao URL especificado no cabeçalho `Location` desta resposta, e não ao URL a que a solicitação foi enviada.

SEE_OTHER (303)

Código do erro	Descrição
`seeOther`	Sua solicitação foi processada. Para receber a resposta, envie uma solicitação `GET` ao URL especificado no cabeçalho `Location`.
`mediaDownloadRedirect`	Sua solicitação foi processada. Para receber a resposta, envie uma solicitação `GET` ao URL especificado no cabeçalho `Location`.

NOT_MODIFIED (304)

Código do erro	Descrição
`notModified`	A condição definida para um cabeçalho "If-None-Match" não foi atendida. Esta resposta indica que o documento solicitado não foi modificado e que uma resposta em cache precisa ser recuperada. Verifique o valor do cabeçalho de solicitação HTTP `If-None-Match`.

TEMPORARY_REDIRECT (307)

Código do erro	Descrição
`temporaryRedirect`	Para que a solicitação seja processada, reenvie-a para o URL especificado no cabeçalho `Location` da resposta.

BAD_REQUEST (400)

Código do erro	Descrição
`badRequest`	A solicitação da API é inválida ou formada de modo inadequado. Consequentemente, o servidor da API não identificou a solicitação.
`badBinaryDomainRequest`	A solicitação de domínio binário é inválida.
`badContent`	O tipo de conteúdo dos dados da solicitação ou o tipo de conteúdo de uma das várias partes de uma solicitação não é compatível.
`badLockedDomainRequest`	A solicitação de domínio bloqueado é inválida.
`corsRequestWithXOrigin`	A solicitação CORS contém um cabeçalho XD3 X-Origin, que é um indicativo de uma solicitação CORS irregular.
`endpointConstraintMismatch`	A solicitação falhou porque não correspondeu à API especificada. Confira se o valor do caminho do URL está correto.
`invalid`	A solicitação falhou porque continha um valor inválido. O valor poderia ser de parâmetro, cabeçalho ou propriedade.
`invalidAltValue`	O valor do parâmetro `alt` especifica um formato de saída desconhecido.
`invalidHeader`	A solicitação falhou porque continha um cabeçalho inválido.
`invalidParameter`	A solicitação falhou porque continha um valor de parâmetro ou um parâmetro inválido. Analise a documentação da API para determinar quais parâmetros são válidos para sua solicitação.
`invalidQuery`	A solicitação é inválida. Confira a documentação da API para determinar quais parâmetros são compatíveis com a solicitação e se esta tem uma combinação inválida de parâmetros ou um valor de parâmetro inválido. Verifique o valor do parâmetro de solicitação `q`.
`keyExpired`	A chave da API fornecida na solicitação expirou. Isso significa que o servidor da API não pode verificar o limite da cota para o aplicativo que está fazendo a solicitação. Confira o Google Developers Console para saber mais ou receber uma nova chave.
`keyInvalid`	A chave da API fornecida na solicitação é inválida. Isso significa que o servidor da API não pode conferir o limite da cota para o app que está fazendo a solicitação. Use o Google Developers Console para encontrar a chave da API ou adquirir uma.
`lockedDomainCreationFailure`	O token do OAuth foi recebido na string de consulta proibida pela API nos formatos de resposta que não sejam JSON ou XML. Se possível, envie o token do OAuth no cabeçalho "Authorization".
`notDownload`	Somente solicitações de downloads de mídia podem ser enviadas para caminhos de URL `/download/*`. Reenvie a solicitação para o mesmo caminho, mas sem o prefixo `/download`.
`notUpload`	Ocorreu uma falha na solicitação porque ela não é de upload. Somente solicitações de upload podem ser enviadas a URIs `/upload/*`. Tente reenviar a solicitação ao mesmo caminho, mas sem o prefixo `/upload`.
`parseError`	O servidor da API não pode analisar o corpo da solicitação.
`required`	Faltam informações necessárias na solicitação da API. Essas informações poderiam ser um parâmetro ou uma propriedade de recurso.
`tooManyParts`	A solicitação de várias partes falhou porque ela contém muitas partes.
`unknownApi`	A API chamada pela solicitação não foi reconhecida.
`unsupportedMediaProtocol`	O cliente está usando um protocolo de mídia incompatível.
`unsupportedOutputFormat`	O valor do parâmetro `alt` especifica um formato de saída que não é compatível com este serviço. Verifique o valor do parâmetro de solicitação `alt`.
`wrongUrlForUpload`	Esta é uma solicitação de upload, mas falhou porque não foi enviada para o URI correto. Solicitações de upload precisam ser enviadas para URIs com o prefixo `/upload/*`. Tente reenviar a solicitação ao mesmo caminho, mas com o prefixo `/upload`.

UNAUTHORIZED (401)

Código do erro	Descrição
`unauthorized`	O usuário não foi autorizado a fazer a solicitação.
`authError`	As credenciais de autorização fornecidas para a solicitação são inválidas. Verifique o valor do cabeçalho de solicitação HTTP `Authorization`.
`expired`	A sessão expirou. Verifique o valor do cabeçalho de solicitação HTTP `Authorization`.
`lockedDomainExpired`	A solicitação falhou porque um domínio válido previamente bloqueado expirou.
`required`	O usuário precisa estar conectado para fazer esta solicitação de API. Verifique o valor do cabeçalho de solicitação HTTP `Authorization`.

PAYMENT_REQUIRED (402)

Código do erro	Descrição
`dailyLimitExceeded402`	Um limite de orçamento diário definido pelo desenvolvedor foi atingido.
`quotaExceeded402`	A operação solicitada exige mais recursos do que a cota permite. É preciso pagar para concluir a operação.
`user402`	A operação solicitada exige algum tipo de pagamento do usuário autenticado.

FORBIDDEN (403)

Código do erro	Descrição
`forbidden`	A operação solicitada é proibida e não pode ser concluída.
`accessNotConfigured`	Seu projeto não está configurado para acessar esta API. Use o Google Developers Console para ativar a API no seu projeto.
`accessNotConfigured`	O projeto foi bloqueado por motivo de abuso. Acesse http://support.google.com/code/go/developer_compliance.
`accessNotConfigured`	O projeto foi marcado para exclusão.
`accountDeleted`	A conta de usuário associada às credenciais de autorização da solicitação foi excluída. Verifique o valor do cabeçalho de solicitação HTTP `Authorization`.
`accountDisabled`	A conta de usuário associada às credenciais de autorização da solicitação foi desativada. Verifique o valor do cabeçalho de solicitação HTTP `Authorization`.
`accountUnverified`	O endereço de e-mail do usuário que fez a solicitação não foi verificado. Verifique o valor do cabeçalho de solicitação HTTP `Authorization`.
`concurrentLimitExceeded`	A solicitação falhou porque um limite de uso simultâneo foi atingido.
`dailyLimitExceeded`	Um limite de cota diário para a API foi atingido.
`dailyLimitExceeded`	O limite de cota diário foi atingido, e o projeto foi bloqueado por motivo de abuso. Veja o formulário de suporte de conformidade das APIs do Google para ajudar a resolver o problema.
`dailyLimitExceededUnreg`	A solicitação falhou porque um limite diário para o uso de uma API não autenticada foi atingido. O uso contínuo da API exige uma inscrição por meio do Google Developers Console.
`downloadServiceForbidden`	A API não é compatível com um serviço de download.
`insufficientAudience`	Não é possível concluir a solicitação para este público-alvo.
`insufficientAuthorizedParty`	Não é possível concluir a solicitação para este aplicativo.
`insufficientPermissions`	O usuário autenticado não tem permissões suficientes para executar esta solicitação.
`limitExceeded`	Não é possível concluir a solicitação devido a limitações de taxa e acesso.
`lockedDomainForbidden`	Esta API não é compatível com domínios bloqueados.
`quotaExceeded`	A operação solicitada exige mais recursos do que a cota permite.
`rateLimitExceeded`	Muitas solicitações foram enviadas em determinado período.
`rateLimitExceededUnreg`	Um limite de taxa foi excedido. Será preciso que você registre seu aplicativo para continuar chamando a API. Inscreva-se usando o Google Developers Console.
`responseTooLarge`	O recurso solicitado é muito grande para ser retornado.
`servingLimitExceeded`	O limite de taxa geral especificado para a API já foi atingido.
`sslRequired`	O SSL é necessário para realizar esta operação.
`unknownAuth`	O servidor da API não reconhece o esquema de autorização usado na solicitação. Verifique o valor do cabeçalho de solicitação HTTP `Authorization`.
`userRateLimitExceeded`	A solicitação falhou porque um limite de taxa por usuário foi atingido.
`userRateLimitExceededUnreg`	Ocorreu uma falha na solicitação porque um limite de taxa por usuário foi atingido e o desenvolvedor de cliente não foi identificado na solicitação. Use o Google Developer Console (https://console.developers.google.com) e crie um projeto para o app.
`variableTermExpiredDailyExceeded`	A solicitação falhou porque uma cota de termo variável expirou e um limite diário foi atingido.
`variableTermLimitExceeded`	A solicitação falhou porque uma cota de termo variável foi atingida.

NOT_FOUND (404)

Código do erro	Descrição
`notFound`	A operação solicitada falhou porque um recurso associado à solicitação não foi encontrado.
`notFound`	Um recurso associado à solicitação não foi encontrado. Caso você não tenha usado esta API nas últimas duas semanas, implemente outra vez o aplicativo App Engine e tente fazer a chamada novamente.
`unsupportedProtocol`	O protocolo usado na solicitação não é compatível.

METHOD_NOT_ALLOWED (405)

Código do erro	Descrição
`httpMethodNotAllowed`	O método HTTP associado à solicitação não é compatível.

CONFLICT (409)

Código do erro	Descrição
`conflict`	Não é possível concluir a solicitação da API porque a operação solicitada entraria em conflito com um item existente. Por exemplo, uma solicitação que tenta criar um item duplicado criaria um conflito, embora itens duplicados sejam tipicamente identificados com erros mais específicos.
`duplicate`	A operação solicitada falhou porque tentou criar um recurso que já existe.

GONE (410)

Código do erro	Descrição
`deleted`	A solicitação falhou porque o recurso associado à solicitação foi excluído.

PRECONDITION_FAILED (412)

Código do erro	Descrição
`conditionNotMet`	A condição definida no cabeçalho de solicitação HTTP `If-Match` ou `If-None-Match` da solicitação não foi atendida. Veja a seção ETag da especificação de HTTP para saber mais detalhes. Verifique o valor do cabeçalho de solicitação HTTP `If-Match`.

REQUEST_ENTITY_TOO_LARGE (413)

Código do erro	Descrição
`backendRequestTooLarge`	A solicitação é muito grande.
`batchSizeTooLarge`	A solicitação em lote contém muitos elementos.
`uploadTooLarge`	A solicitação falhou porque os dados enviados são muito grandes.

REQUESTED_RANGE_NOT_SATISFIABLE (416)

Código do erro	Descrição
`requestedRangeNotSatisfiable`	A solicitação especificou um intervalo inviável.

EXPECTATION_FAILED (417)

Código do erro	Descrição
`expectationFailed`	A expectativa de um cliente não pode ser atendida pelo servidor.

PRECONDITION_REQUIRED (428)

Código do erro	Descrição
`preconditionRequired`	A solicitação exige um pré-requisito que não foi fornecido. Para que essa solicitação seja bem-sucedida, você precisa fornecer um cabeçalho `If-Match` ou `If-None-Match` com ela.

TOO_MANY_REQUESTS (429)

Código do erro	Descrição
`rateLimitExceeded`	Muitas solicitações foram enviadas em determinado período.

INTERNAL_SERVER_ERROR (500)

Código do erro	Descrição
`internalError`	A solicitação falhou devido a um erro interno.

NOT_IMPLEMENTED (501)

Código do erro	Descrição
`notImplemented`	A operação solicitada não foi implementada.
`unsupportedMethod`	A solicitação falhou porque está tentando executar uma operação ou um método desconhecido.

SERVICE_UNAVAILABLE (503)

Código do erro	Descrição
`backendError`	Ocorreu um erro de back-end.
`backendNotConnected`	A solicitação falhou devido a um erro de conexão.
`notReady`	O servidor da API não está pronto para aceitar solicitações.