Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Erros da API Indexing
Este documento identifica alguns dos códigos e mensagens de erro 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:
Esta solicitação, bem como as futuras para a mesma operação, precisam ser enviadas ao URL especificado no cabeçalho Location desta resposta, e não ao URL para onde 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 sua solicitação seja processada, reenvie-a para o URL especificado no cabeçalho Location desta resposta.
BAD_REQUEST (400)
Código do erro
Descrição
badRequest
A solicitação de API é inválida ou foi formada de modo incorreto. Como consequência, 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
Ocorreu uma falha na solicitação porque ela não correspondeu à API especificada. Verifique o valor do caminho do URL para conferir se ele está correto.
invalid
Ocorreu uma falha na solicitação porque ela 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
Ocorreu uma falha na solicitação porque ela continha um cabeçalho inválido.
invalidParameter
Ocorreu uma falha na solicitação porque ela continha um parâmetro ou um valor de 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. Verifique a documentação da API para determinar quais parâmetros são compatíveis com a solicitação e para ver se a solicitação contém 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 consegue verificar o limite da cota para o aplicativo que está fazendo a solicitação. Consulte o Google Developers Console para ver mais informações ou receber uma nova chave.
keyInvalid
A chave de API fornecida na solicitação é inválida. Isso significa que o servidor da API não consegue verificar o limite da cota para o aplicativo que está fazendo a solicitação. Use o Google Developers Console para encontrar sua chave da API ou adquirir uma.
lockedDomainCreationFailure
O token OAuth foi recebido na string de consulta, o que a API proíbe em formatos de resposta que não sejam JSON ou XML. Se possível, envie o token 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 é uma solicitação de upload, e somente elas 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 obrigatórias na solicitação de API. Essas informações podem ser um parâmetro ou uma propriedade de recurso.
tooManyParts
Ocorreu uma falha na solicitação de várias partes porque ela tem muitos componentes.
unknownApi
A API chamada pela solicitação não foi reconhecida.
unsupportedMediaProtocol
O cliente está usando um protocolo de mídia não compatível.
unsupportedOutputFormat
O valor do parâmetro alt especifica um formato de saída que não é compatível com este serviço. Confira 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
Sessão expirada. Verifique o valor do cabeçalho de solicitação HTTP Authorization.
lockedDomainExpired
A solicitação falhou porque um domínio válido bloqueado anteriormente expirou.
required
O usuário precisa fazer login para fazer essa solicitação da API. Verifique o valor do cabeçalho da 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.
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 confirmado. 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.
Ocorreu uma falha na solicitação porque um limite diário para uso não autenticado da API 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 um determinado período.
rateLimitExceededUnreg
Um limite de taxa foi excedido. 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
É preciso ter SSL 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
Ocorreu uma falha na solicitação 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 Developers Console (https://console.developers.google.com) para criar um projeto para o app.
variableTermExpiredDailyExceeded
Ocorreu uma falha na solicitação porque uma cota de termo variável expirou e um limite diário foi atingido.
variableTermLimitExceeded
Ocorreu uma falha na solicitação porque um limite de cota de termo variável foi atingido.
NOT_FOUND (404)
Código do erro
Descrição
notFound
Ocorreu uma falha na operação solicitada porque não foi possível encontrar um recurso associado à solicitação.
notFound
Não foi encontrado um recurso associado à solicitação. Se você não usou esta API nas últimas duas semanas, reinstale o aplicativo do App Engine e tente chamá-la 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 tentasse criar um item duplicado geraria um conflito, embora itens duplicados sejam tipicamente identificados com erros mais específicos.
duplicate
Ocorreu uma falha na operação solicitada porque ela 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 mais detalhes na seção ETag da especificação de HTTP. 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
Ocorreu uma falha na solicitação porque os dados enviados na solicitação 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 requer uma precondição que não foi fornecida. 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
Ocorreu uma falha na solicitação devido a um erro interno.
NOT_IMPLEMENTED (501)
Código do erro
Descrição
notImplemented
A operação solicitada não foi implementada.
unsupportedMethod
Ocorreu uma falha na solicitação porque ela 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
Ocorreu uma falha na solicitação devido a um erro de conexão.
notReady
O servidor da API não está pronto para aceitar solicitações.
Erros específicos da API Indexing
Em todos os casos abaixo, a solicitação foi rejeitada, e o URL não pode ser rastreado pelo Google. Isso também se aplica às mensagens de erro principais.
BAD_REQUEST (400)
Mensagem de erro
Descrição
Missing attribute. 'url' attribute is required.
O usuário não definiu o URL na solicitação.
Invalid attribute. 'url' is not in standard URL format
O usuário definiu um URL que não parece um URL, por exemplo, "abcd".
Unknown type. 'type' attribute is required and must be 'URL_REMOVED' or 'URL_UPDATED'.
O usuário não definiu o tipo de notificação.
Invalid value at 'url_notification.type' (TYPE_ENUM)
O usuário definiu o tipo de notificação como algo diferente de URL_REMOVED ou URL_UPDATED.
FORBIDDEN (403)
Mensagem de erro
Descrição
Permission denied. Failed to verify the URL ownership.
O usuário não concluiu o processo de verificação de propriedade ou está tentando atualizar um URL que não é dele.
TOO_MANY_REQUESTS (429)
Mensagem de erro
Descrição
Insufficient tokens for quota 'indexing.googleapis.com/default_requests'
O usuário está excedendo a cota que ele tem da API Indexing.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-02-17 UTC."],[[["This document outlines common Google API error codes, focusing on the global error domain and Indexing API-specific errors."],["Errors are structured in JSON format, providing details like domain, reason, message, and HTTP status code for easier debugging."],["Error categories are organized by HTTP status codes (3xx, 4xx, 5xx), with detailed descriptions for each code within those categories."],["The Indexing API has specific errors related to request rejection and URL crawling issues, such as missing URLs or permission issues."],["Refer to the full document for in-depth explanations and troubleshooting guidance for each error code."]]],[]]