Referência

Erros e limites de taxa

Erros REST usam este envelope. Mantenha a solicitação ID para suporte e nunca registre sua chave API:

Comece com código e requestId

O código estável informa ao seu programa o que aconteceu. A mensagem legível explica esta solicitação. Salve requestId ao entrar em contato com o suporte.

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

Corrija erros de autenticação e plano

Para 401, verifique se o cabeçalho começa com Bearer seguido por um espaço e uma chave ativa. Para 403, verifique o plano de contas e os escopos selecionados quando a chave foi criada.

Corrigir erros de estado de upload

Para 409 ou 422, confirme se PUT foi concluído, se o Content-Type corresponde e se a contagem de bytes carregados é igual a sizeBytes. Crie um novo trabalho de upload se o URL temporário expirou.

Código	HTTP	Significado
BAD_REQUEST	400 / 409	HTTP 400 significa que o corpo da solicitação é inválido; HTTP 409 significa que o upload não pode ser concluído em seu estado atual.
UNAUTHORIZED	401	A chave API está ausente, é inválida ou foi revogada.
PAID_PLAN_REQUIRED	403	A conta não possui um plano pago elegível.
INSUFFICIENT_SCOPE	403	A chave API não inclui o escopo necessário.
NOT_FOUND	404	O upload, arquivo ou compartilhamento de propriedade não foi encontrado.
UPLOAD_NOT_READY	409	O objeto carregado não está pronto para conclusão.
FILE_TOO_LARGE	413	O arquivo excede o limite de tamanho aplicável.
OBJECT_VALIDATION_FAILED	422	O objeto carregado falhou na validação.
QUOTA_EXCEEDED	429	A cota de upload acabou.
RATE_LIMIT_EXCEEDED	429	A taxa de solicitação API se esgotou.
SERVICE_UNAVAILABLE	503	Um serviço necessário está temporariamente indisponível.

Cabeçalhos com limite de taxa

Tente novamente 429 somente após Retry-After. Tente novamente erros 503 temporários com espera exponencial. Não tente novamente solicitações 400, 401 ou 403 inválidas automaticamente.