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 [url], then retry.
If you enabled this API recently, wait a few minutes for the action to
propagate and retry.
  1. Aceda ao link especificado na mensagem de erro e ative a API Document AI. Aguarde vários minutos e, em seguida, tente novamente.
  2. Verifique se tem um ficheiro JSON de chave da conta de serviço válido armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. 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
    

Erro ao escrever o resultado final

Se receber uma mensagem como a seguinte quando receber os resultados de um pedido de processo em lote:

{
  "name": "projects/project-name/operations/operation-id",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.document.v1beta1.OperationMetadata",
    "state": "SUCCEEDED",
    "createTime": "2019-09-19T02:02:15.885267760Z",
    "updateTime": "2019-09-19T02:02:31.896425001Z"
  },
  "done": true,
  "error": {
    "code": 5,
    "message": "Error writing final output to: gs://bucket-name/filename.json"
  }
}

A sua conta de serviço pode não ter as autorizações corretas para criar objetos no seu contentor do Cloud Storage. Certifique-se de que atribuiu as autorizações corretas à sua conta de serviço, conforme descrito no início rápido.

Também pode ter escrito incorretamente o nome do seu contentor do Cloud Storage. Verifique se o contentor ao qual está a tentar aceder existe.

O P4SA não tem acesso ao Cloud Storage

Quando a conta de serviço por produto (P4SA) do Document AI não tem autorização para aceder a alguns recursos do Cloud Storage.

message: "Cloud DocumentAI P4SA doesn't have access to this Cloud Storage resource:"

A conta de serviço não pode criar um objeto no Cloud Storage

Quando a conta de serviço por produto (P4SA) do Document AI não tem autorização para criar um objeto no Cloud Storage.

message: "Service account service-123@gcp-sa-prod-dai-core.iam.gserviceaccount.com
         does not have permission storage.objects.create to create
         Google Cloud Storage object in bucket gs://foo."

A conta de serviço do Document AI pode não ter as autorizações corretas para criar objetos no seu contentor do Cloud Storage. Certifique-se de que atribuiu as autorizações corretas à conta de serviço da IA Documental, conforme descrito na configuração do acesso a ficheiros entre projetos.

Também pode ter escrito incorretamente o nome do seu contentor do Cloud Storage. Verifique se o contentor ao qual está a tentar aceder existe.

O autor da chamada não consegue obter objetos no Cloud Storage

Quando o autor da chamada da API Document AI não tem autorização para obter objetos no Cloud Storage.

message: "The caller does not have permission storage.objects.get to get Google
         Cloud Storage objects in bucket gs://foo."

O autor da chamada da API pode não ter as autorizações corretas para obter objetos no seu contentor do Cloud Storage. Certifique-se de que atribuiu as autorizações corretas ao autor da chamada.

Também pode ter escrito incorretamente o nome do seu contentor do Cloud Storage. Verifique se o contentor ao qual está a tentar aceder existe.

Argumentos inválidos

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

Versão da API não suportada

Quando é feito um pedido a uma versão da API que não suporta a operação.

message: "The requested operation is unsupported for the API version."

O tipo de processador não é suportado

Quando é feito um pedido a um método de API que não suporta o tipo de processador indicado.

message: "The requested operation is unsupported for the processor type: ${PROCESSOR_TYPE}."

Pedido errado

Quando é feito um pedido de API, mas os campos do pedido têm uma ou mais violações. Cada violação é captada como um field_violations nos google.rpc.BadRequest detalhes.

message: "Request contains an invalid argument."
details {
  [type.googleapis.com/google.rpc.BadRequest] {
    field_violations { field: "foo" description: "bar" }
  }
}

Falha ao processar todos os documentos em lote

Quando ocorre uma falha no processamento de todos os documentos num pedido de processamento em lote.

message: "Failed to process all documents."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "FAILED_TO_PROCESS_ALL_DOCUMENTS"
    domain: "documentai.googleapis.com"
  }
}

Não existem documentos

Quando são necessários ou esperados documentos, mas não é fornecido nenhum, como quando importa documentos através do URI do Cloud Storage.

message: "No valid documents found in ${training|test} directory. Ensure files are in a supported MIME type. For details, see https://cloud.google.com/document-ai/docs/file-types."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_DOCUMENTS"
    domain: "documentai.googleapis.com"
  }
}

Os parâmetros gcsUriPrefix e gcsOutputConfig.gcsUri têm de começar por gs:// e terminar com um caráter de barra invertida (/). Verifique a configuração dos URIs do contentor.

Exemplo: gs://bucket/directory/

O treino não é suportado

Quando é feito um pedido de versão do processador de treino num tipo de processador que não suporta o treino.

message: "Training is not supported on processor type: ${DOCUMENT_TYPE}_PROCESSOR."

Nenhum documento selecionado

Quando são esperados documentos, mas nenhum é selecionado no conjunto de dados, como quando cria tarefas de etiquetagem de dados.

message: No documents selected. Please select at least one document."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_DOCUMENTS_SELECTED"
    domain: "documentai.googleapis.com"
  }
}

Tipo de documento não encontrado

Quando a classe de um documento (como carta de condução, passaporte ou fatura) não corresponde à classificação necessária para o tipo de processador. Um exemplo é quando o passo do classificador no analisador W2 não encontra elementos numa fatura.

Isto também pode aparecer como Couldn't preview the document: Unable to find a document of type: 'foo' na Google Cloud consola. Esta mensagem de erro aplica-se a processadores antigos.

message: "Unable to find a document of type: 'foo'"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_OF_TYPE_NOT_FOUND"
    domain: "documentai.googleapis.com"
  }
}

O limite de tamanho do documento foi excedido

Quando o limite superior do tamanho do ficheiro de um documento é excedido durante a importação do conjunto de dados ou durante a execução da previsão.

message: "Document size (2) exceeds limit: 1 (bytes)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SIZE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "limit" value: "1" }
    metadata { key: "size" value: "2" }
  }
}

Limite de documentos excedido

Quando o limite superior da contagem de documentos foi excedido.

message: "Document count exceed the limit: 5 got 6"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "document_limit" value: "5" }
    metadata { key: "documents" value: "6" }
  }
}

Tipo MIME não suportado

Quando foi fornecido um tipo MIME não suportado. O sistema valida o formato do ficheiro (tipo MIME) quando importa um conjunto de dados ou faz uma chamada de previsão. Aceda a Ficheiros suportados (e para o analisador de esquemas) para ver os tipos de ficheiros disponíveis. Se o formato de ficheiro não for suportado, é apresentada a seguinte mensagem de erro:

message: "INVALID_ARGUMENT: Unsupported MIME type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "UNSUPPORTED_MIME_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "mime_type" value: "foo" }
  }
}

Nenhuma página

Quando foi facultado um documento sem páginas, mas são necessárias uma ou mais páginas.

message: "No pages were found in the document."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NO_PAGES"
    domain: "documentai.googleapis.com"
  }
}

Número de página negativo

Quando um documento indica um valor negativo para um dos seus números de páginas.

message: "Page number cannot be negative."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "NEGATIVE_PAGE_NUMBER"
    domain: "documentai.googleapis.com"
  }
}

Números de páginas duplicados

Quando um documento indica o mesmo número de página uma ou mais vezes.

message: "Duplicate page number detected (page numbers to indices): [{1, [1, 2]}, {4, [4, 5]}]."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DUPLICATE_PAGE_NUMBERS"
    domain: "documentai.googleapis.com"
    metadata {
      key: "page_number_to_indices"
      value: "[{1, [1, 2]}, {4, [4, 5]}]"
    }
  }
}

Limite de páginas excedido

Quando o limite superior do número total de páginas de um documento é excedido. Encontra este erro durante a importação ou a previsão do conjunto de dados quando um documento no conjunto de dados tem demasiadas páginas, excedendo os limites do processador.

message: "Document pages exceed the limit: 5 got 6"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
    metadata { key: "page_limit" value: "5" }
    metadata { key: "pages" value: "6" }
  }
}

Limite de páginas excedido no modo sem imagens

Encontra este erro durante a importação ou a previsão do conjunto de dados quando um documento no conjunto de dados tem demasiadas páginas, excedendo os limites do processador. Pode pedir que o seu projeto seja adicionado a uma lista de autorizações para ativar o modo sem imagens. Isto aumenta o limite de páginas para 30.

message: "Document pages in non-imageless mode exceed the limit: 15 got 16. Try using imageless mode to increase the limit to 30."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_LIMIT_EXCEEDED_IN_IMAGELESS_MODE"
    domain: "documentai.googleapis.com"
    metadata { key: "page_limit" value: "15" }
    metadata { key: "pages" value: "16" }
    metadata { key: "imageless_page_limit" value: "30" }
  }
}

Alteração do estado da versão do processador pré-treinado

Quando foi emitido um pedido para alterar o estado de uma versão do processador pré-treinado. Encontra este erro quando tenta eliminar uma versão de processador pré-treinado.

message: "ProcessorVersion with id 'xyz' is pretrained by Google and cannot change states."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PRETRAINED_PROCESSOR_VERSION_STATE_CHANGE"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "target_state" value: "DELETING" }
    metadata { key: "version_id" value: "xyz" }
  }
}

Validação do conjunto de dados

Quando um conjunto de dados não cumpre os critérios de validação, por exemplo, devido a âncoras de páginas em falta, dados incorretos ou detalhes incompletos em alguns atributos do objeto proto do documento.

message: "Invalid dataset. See operation metadata for specific errors."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_DATASET"
    domain: "documentai.googleapis.com"
  }
}

Documento não inline para revisão com intervenção humana

Quando foi iniciada uma revisão humana para um documento que não foi definido inline.

message: "The document for review must be provided inline."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "HUMAN_REVIEW_NON_INLINED_DOCUMENT"
    domain: "documentai.googleapis.com"
  }
}

Tipo de documento inválido

Quando o tipo de documento é inválido ou não é suportado pelo processador. Um tipo de documento refere-se à categoria do documento (por exemplo, W2) e não o respetivo formato de ficheiro ou tipo MIME, como PDF ou JPEG.

message: "Invalid document type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_DOCUMENT_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "type" value: "foo" }
  }
}

O intervalo do documento está fora dos limites

message: "Text span [1, 5) is out of bounds: [1, 3)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SPAN_OUT_OF_BOUNDS"
    domain: "documentai.googleapis.com"
    metadata { key: "bounds" value: "[1, 3)" }
    metadata { key: "span" value: "[1, 5)" }
    metadata { key: "type" value: "Text" }
  }
}

Intervalo de documentos inválido

Quando é fornecido um intervalo de documentos inválido, como o início ser posterior ao fim.

message: "Character span is invalid. Ensure the max is greater than the min."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_SPAN_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "span" value: "Character" }
  }
}

Documento UTF-8 inválido

Quando é fornecido um documento que inclui UTF-8 inválido.

message: "Document contains invalid UTF-8 text."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_INVALID_UTF_8"
    domain: "documentai.googleapis.com"
    metadata { key: "bytes" value: "[2, 3)" }
  }
}

O esquema do conjunto de dados é inválido

Quando um processador não tem um esquema de união válido ou o esquema do conjunto de dados fornecido não é válido.

message: "The processor has an empty or invalid schema: "
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_SCHEMA_ERROR"
    domain: "documentai.googleapis.com"
  }
}

OcrConfig não suportado

Quando é emitido um pedido de processamento para um processador que não suporta OcrConfig.

message: "OcrConfig is not supported for processor type: 'foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "OCR_CONFIG_UNSUPPORTED"
    domain: "documentai.googleapis.com"
  }
}

Configuração de importação inválida

Quando a configuração de importação é inválida.

message: "The import config is invalid: foo"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_IMPORT_CONFIG"
    domain: "documentai.googleapis.com"
  }
}

A versão do processador de origem é inválida

Ao tentar importar uma versão do processador, a versão do processador de origem não é válida para importação.

message: "The source processor version is invalid in import processor version."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_SOURCE_PROCESSOR_VERSION_ERROR"
    domain: "documentai.googleapis.com"
  }
}

Tamanho do fragmento inválido

Quando a configuração do tamanho do fragmento é inválida.

message: "Invalid chunk size. Requested chunk size (${CHUNK_SIZE}) must be in the range of [${MIN_CHUNK_SIZE}, ${MAX_CHUNK_SIZE}]."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INVALID_ARGUMENT"
    domain: "documentai.googleapis.com"
  }
}

Falha na pré-condição

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

Chave do KMS inválida

Quando foi fornecida uma chave inválida (por exemplo, está desativada).

message: "KMS key 'projects/1/keys/abc' is invalid (KEY_DISABLED)."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "KMS_KEY_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "details" value: "KEY_DISABLED" }
    metadata { key: "kms_key_name" value: "projects/1/keys/abc" }
  }
}

Alteração do estado do processador

Quando é emitido um pedido inválido para alterar o estado de um processador.

message: "Processor state cannot be changed to 'DISABLED' since it is 'DISABLED'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_STATE_CHANGE_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "current_state" value: "DISABLED" }
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "target_state" value: "DISABLED" }
  }
}

Alteração do estado da versão do processador

Quando é emitido um pedido inválido para alterar o estado de uma versão do processador.

message: "ProcessorVersion state cannot be changed to 'DEPLOYING' since it is 'DEPLOYED'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_STATE_CHANGE_INVALID"
    domain: "documentai.googleapis.com"
    metadata { key: "current_state" value: "DEPLOYED" }
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "target_state" value: "DEPLOYING" }
    metadata { key: "version_id" value: "xyz" }
  }
}

Processador não ativado

Quando é emitido um pedido que depende de um processador específico, mas o processador não está ativado.

message: "Processor 'xyz' is not enabled."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_NOT_ENABLED"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "state" value: "DISABLED" }
  }
}

A versão do processador não foi implementada

Quando é emitido um pedido que depende da implementação de uma versão específica do processador, mas o processador não está implementado.

message: "ProcessorVersion 'abc' is not deployed."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_NOT_DEPLOYED"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "state" value: "TRAINING" }
    metadata { key: "version_id" value: "abc" }
  }
}

Versão predefinida do processador

Quando é emitido um pedido que depende de uma versão predefinida configurada, mas não existe nenhuma configurada.

message: "Processor 'xyz' does not have a default version configured."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_DEFAULT_VERSION_UNSET"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
  }
}

Processador: remover versão predefinida

Quando é emitido um pedido para anular a implementação ou eliminar uma versão do processador, mas esta está configurada como a versão predefinida.

message: "ProcessorVersion 'xyz' cannot be undeployed or deleted as it is the default version."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_REMOVE_DEFAULT_VERSION"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "abc" }
    metadata { key: "version_id" value: "xyz" }
  }
}

Conjunto de dados não inicializado

Quando é emitido um pedido que requer a inicialização de um conjunto de dados, mas o conjunto de dados não é inicializado.

message: "Dataset is not initialized."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_NOT_INITIALIZED"
    domain: "documentai.googleapis.com"
  }
}

Conjunto de dados inicializado ou a ser inicializado

Quando é emitido um pedido que requer que um conjunto de dados seja não inicializado, mas o conjunto de dados já está inicializado ou está a ser inicializado.

message: "Dataset is already initialized or is initializing."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_INITIALIZED_OR_INITIALIZING"
    domain: "documentai.googleapis.com"
  }
}

Erro de localização do conjunto de dados não vazio

Quando um pedido requer que uma localização de armazenamento do conjunto de dados esteja vazia, mas a pasta contém objetos.

message: "Given dataset location is not empty. Please select an empty folder."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_LOCATION_NOT_EMPTY"
    domain: "documentai.googleapis.com"
  }
}

Has Blocking Operation Error

Quando existem outras operações em execução que estão a bloquear a operação necessária.

message: "The operation cannot be performed due to an ongoing 'EXAMPLE_OPERATION_TYPE' blocking operation. Try again after the operation finishes."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "HAS_BLOCKING_OPERATION_ERROR"
    domain: "documentai.googleapis.com"
  }
}

Erro de intervalo de páginas não suportado

Quando o campo page_range não é suportado em alguma operação, como num processo em lote.

message: "Page range is not supported."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PAGE_RANGE_UNSUPPORTED"
    domain: "documentai.googleapis.com"
  }
}

A pasta do Cloud Storage contém um erro no conjunto de dados

Quando uma pasta do Cloud Storage já contém um conjunto de dados.

message:  "The folder 'folder_uri' already has dataset 'dataset-id' under it."
details {
   [type.googleapis.com/google.rpc.ErrorInfo] {
     reason: "GCS_FOLDER_CONTAINS_DATASET_ERROR"
     domain: "documentai.googleapis.com"
   }
}

Erro de miniatura em falta

Quando não é possível obter a miniatura de um documento do conjunto de dados.

message:  "Failed to get dataset document thumbnail, consider running re-sync on the dataset."
details {
   [type.googleapis.com/google.rpc.ErrorInfo] {
     reason: "THUMBNAIL_MISSING"
     domain: "documentai.googleapis.com"
   }
}

Limite de páginas do conjunto de dados excedido

Quando o limite total de páginas de um conjunto de dados foi excedido.

message: "Dataset page count exceeds the limit of 5. Got 6."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DATASET_PAGE_LIMIT_EXCEEDED"
    domain: "documentai.googleapis.com"
  }
}

Processador não suportado para processamento síncrono

Quando é feito um pedido de uma versão do processador que já não é suportada para processamento síncrono.

message: "Processor ${PROCESSOR_ID} version ${VERSION_ID} of type ${TYPE_NAME} is no longer supported for sync processing. Please upgrade to a newer version: https://cloud.google.com/document-ai/docs/manage-processor-versions."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "UNSUPPORTED_PROCESSOR"
    domain: "documentai.googleapis.com"
  }
}

Não encontrado

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

Avaliação não encontrada

Quando não é possível encontrar uma avaliação para uma versão do processador.

message: "Evaluation with ID 'qrs' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "EVALUATION_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "evaluation_id" value: "qrs" }
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "version_id" value: "abc" }
  }
}

Documento não encontrado

Quando não é possível encontrar um documento necessário para uma operação.

message: "Document not found: 'gs://foo'."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "DOCUMENT_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "document" value: "gs://foo" }
  }
}

Processador não encontrado

Quando não é possível encontrar um processador necessário para uma operação.

message: "Processor with id 'xyz' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
  }
}

Versão do processador não encontrada

Quando não é possível encontrar uma versão do processador necessária para uma operação.

message: "ProcessorVersion with id 'abc' not found."
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "PROCESSOR_VERSION_NOT_FOUND"
    domain: "documentai.googleapis.com"
    metadata { key: "processor_id" value: "xyz" }
    metadata { key: "version_id" value: "abc" }
  }
}

Não foi possível encontrar a tarefa de etiquetagem de dados

Quando não é possível encontrar uma tarefa de etiquetagem de dados.

message: "Data labeling job with id 'EXAMPLE_DATA_LABELING_JOB' not found in processor EXAMPLE_PROCESSOR."

Versão do esquema não encontrada

Quando não é possível encontrar uma versão do esquema.

message: "Schema version with id 'EXAMPLE_SCHEMA_VERSION' not found."

Esquema não encontrado

Quando não é possível encontrar um esquema.

message: "Schema with id 'EXAMPLE_SCHEMA' not found."

Já existe

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

O etiquetador humano no circuito já existe

Quando cria um conjunto de etiquetadores que já existe.

message: "The labeler pool already exists."

O nome a apresentar da versão do esquema já existe

Quando cria uma versão do esquema com um nome a apresentar que já existe.

message: "A schema version with the name 'EXAMPLE_SCHEMA_VERSION' already exists."

O nome a apresentar do esquema já existe

Quando cria um esquema com um nome a apresentar que já existe.

message: "A schema with the name 'EXAMPLE_SCHEMA' already exists."

Quotas e limites

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

Quota excedida

Se receber esta mensagem:

RESOURCE_EXHAUSTED: Quota exceeded.

Atingiu o limite da sua quota por minuto ou diária. Reveja as quotas e os limites para usar a IA Documentos.

Pode pedir um aumento das suas quotas na Google Cloud consola.

Indisponibilidades e latência

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

Limites de tempo

A operação não foi concluída dentro do tempo limite designado.

Se receber as seguintes mensagens de erro (ou semelhantes) ao sondar uma operação de longa duração (LRO):

google.api_core.future.polling._OperationNotComplete
...
google.api_core.exceptions.RetryError: Deadline of 0.0s exceeded while calling target function, last exception:
...
concurrent.futures._base.TimeoutError: Operation did not complete within the designated timeout.

Em seguida, o valor de tempo limite definido pelo utilizador para a conclusão da operação é demasiado baixo para o documento que está a ser processado. Este erro não indica que a operação do processo em lote falhou. A operação continua independentemente do valor de tempo limite definido pelo utilizador.

Erro do filtro de segurança

Ocorreu um erro interno do lado do servidor porque o pedido ou a resposta foi bloqueado pelos filtros de segurança do modelo de linguagem (conteúdo extenso) (MDI/CE). Não é possível tentar novamente este erro.

message: "Safety filter error."

Erro interno

Ocorreu um erro interno do lado do servidor. Tente estabelecer ligação novamente.

message: "Internal error encountered."