Mensagens de erro

Saiba como resolver alguns erros apresentados pela IA Documental. Este tópico aborda erros cuja resolução requer mais passos do que os que podem ser descritos numa mensagem de erro.

Consulte a documentação da API Cloud para ver as práticas recomendadas de processamento de erros.

Autorizações

A resolução requer a execução de alguns passos, conforme descrito na mensagem de erro.

As credenciais padrão da aplicação não estão disponíveis

Se receber esta mensagem:

The Application Default Credentials are not available. They are
available if running in Compute Engine. Otherwise, the
environment variable GOOGLE_APPLICATION_CREDENTIALS must be defined
pointing to a file defining the credentials.
See https://developers.google.com/accounts/docs/application-default-credentials
for more information.

O Document AI usa Credenciais padrão da aplicação para autenticação.

Tem de ter uma conta de serviço para o seu projeto, transferir a chave (ficheiro JSON) para o seu ambiente de desenvolvimento e, em seguida, definir a localização desse ficheiro JSON para uma variável de ambiente denominada GOOGLE_APPLICATION_CREDENTIALS.

Além disso, a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS tem de estar disponível no contexto em que chama a API Document AI. Por exemplo, se definir a variável a partir de uma sessão de terminal, mas executar o código no depurador do IDE, o contexto de execução do código pode não ter acesso à variável. Nessa circunstância, o seu pedido ao Document AI pode falhar por falta de autenticação adequada.

Para mais informações sobre como definir a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS, consulte o início rápido do Document AI ou a documentação sobre a utilização das Credenciais padrão da aplicação.

Autorização recusada

Se receber esta mensagem:

ERROR: (gcloud.auth.application-default.print-access-token) File
(pointed by GOOGLE_APPLICATION_CREDENTIALS environment variable) does not exist!
{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "status": "PERMISSION_DENIED"
  }
}

Verifique se tem um ficheiro JSON de chave da conta de serviço válido na localização armazenada na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS e se a variável aponta para o local correto.

Para diagnosticar este erro, tente abrir o ficheiro de chave da conta de serviço a partir da pasta a partir da qual está a tentar chamar a API Document AI.

cat $GOOGLE_APPLICATION_CREDENTIALS

Proibido: 403 A API POST não foi usada ou está desativada

Se receber a mensagem:

Forbidden: 403 POST Document AI API has not been used in
project # before or it is disabled.
Enable it by visiting