Esta página foi traduzida pela API Cloud Translation.

Mensagens de erro

Saiba como resolver alguns erros relacionados à Document AI. Neste tópico, falamos sobre erros com resoluções que exigem mais etapas do que as descritas em uma mensagem de erro.

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

Permissões

A resolução exige algumas etapas, conforme descrito na mensagem de erro.

As credenciais padrão do aplicativo não estão disponíveis

Se você recebeu 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.

A Document AI usa Application Default Credentials para autenticação.

É necessário ter uma conta de serviço para seu projeto, fazer o download da chave (arquivo JSON) da sua conta de serviço no ambiente de desenvolvimento e definir o local desse arquivo JSON em uma variável de ambiente denominada GOOGLE_APPLICATION_CREDENTIALS.

Além disso, a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS precisa estar disponível no contexto em que você chama a API Document AI. Por exemplo, se você definir a variável a partir de uma sessão do terminal, mas executou seu código no depurador do ambiente de desenvolvimento integrado, o contexto de execução do seu código poderá não ter acesso à variável. Nesse caso, sua solicitação para a 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 guia de início rápido da Document AI ou a documentação sobre como usar o Application Default Credentials.

Permissão negada

Se você recebeu 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 você tem um arquivo JSON de chave de conta de serviço válido no local armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS e se a variável aponta para o local correto.

Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Document AI.

cat $GOOGLE_APPLICATION_CREDENTIALS

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

Se você 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.

Acesse o link especificado na mensagem de erro e ative a API Document AI. Aguarde alguns minutos e tente novamente.
Verifique se você tem um arquivo JSON de chave de conta de serviço válido armazenado na variável de ambiente GOOGLE_APPLICATION_CREDENTIALS. Para diagnosticar esse erro, tente abrir o arquivo de chave da conta de serviço na pasta que você quer chamar a API Document AI.
```
cat $GOOGLE_APPLICATION_CREDENTIALS
```

Erro ao gravar a saída final

Se você receber uma mensagem como esta ao receber os resultados de uma solicitação 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"
  }
}

Sua conta de serviço pode não ter as permissões corretas para criar objetos no bucket do Cloud Storage. Confira se você atribuiu as permissões corretas à sua conta de serviço, conforme descrito no guia de início rápido.

Talvez você tenha digitado o nome do bucket do Cloud Storage errado. Verifique se o bucket que você está tentando acessar existe.

P4SA sem acesso ao Cloud Storage

Quando a conta de serviço por produto (P4SA) da Document AI não tem permissão para acessar 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 consegue criar objetos no Cloud Storage

Quando a conta de serviço por produto (P4SA) da Document AI não tem permissão para criar objetos 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 da Document AI pode não ter as permissões corretas para criar objetos no bucket do Cloud Storage. Verifique se você atribuiu as permissões corretas à conta de serviço da Document AI, conforme descrito na configuração de acesso a arquivos entre projetos.

Talvez você tenha digitado o nome do bucket do Cloud Storage errado. Verifique se o bucket que você está tentando acessar existe.

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

Quando o autor da chamada da API Document AI não tem permissão para receber 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 permissões corretas para receber objetos no seu bucket do Cloud Storage. Verifique se você atribuiu as permissões corretas ao autor da chamada.

Talvez você tenha digitado o nome do bucket do Cloud Storage incorretamente. Verifique se o bucket que você está tentando acessar existe.

Argumentos inválidos

A resolução exige algumas etapas, conforme descrito na mensagem de erro.

Versão da API não aceita

Exemplo: quando uma solicitação é feita para uma versão da API que não oferece suporte à operação.

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

Bad Request (Solicitação inválida)

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

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

Falha no processamento em lote de todos os documentos

Quando todos os documentos em uma solicitação de processamento em lote falham.

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

Nenhum documento encontrado

Quando documentos são necessários ou esperados, mas nenhum é fornecido, como ao importar documentos pelo 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 precisam começar com gs:// e terminar com um caractere barra invertida (/). Verifique a configuração dos URIs do bucket.

Exemplo: gs://bucket/directory/

O treinamento não é compatível

Quando um pedido de versão do processador de treinamento é feito em um tipo de processador que não oferece suporte ao treinamento.

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

Nenhum documento selecionado

Quando documentos são esperados, mas nenhum é selecionado no conjunto de dados, como ao criar jobs de rotulagem 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 carteira de habilitação, passaporte ou fatura) não corresponde à classificação necessária para o tipo de processador. Um exemplo é quando a etapa do classificador no analisador W2 não encontra elementos de uma fatura.

Ela também pode aparecer como Couldn't preview the document: Unable to find a document of type: 'foo' no console do Google Cloud. Esta mensagem de erro é aplicável a processadores legados.

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

Limite de tamanho do documento excedido

Quando o limite máximo do tamanho de um documento é excedido durante a importação do conjunto de dados ou 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 máximo de contagem de documentos é 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 sem suporte

Quando um tipo MIME não compatível foi fornecido. O sistema verifica o formato do arquivo (tipo MIME) quando você importa um conjunto de dados e faz uma chamada de previsão. Se o formato de arquivo não tiver suporte, a seguinte mensagem de erro vai aparecer:

message: "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" }
  }
}

Tipo MIME de documento incorreto

Quando o conteúdo do documento não corresponde ao tipo MIME especificado. O sistema verifica o formato do arquivo (tipo MIME) quando você importa um conjunto de dados e faz uma chamada de previsão. Se o formato do arquivo fornecido não corresponder ao esperado, a seguinte mensagem de erro vai aparecer:

message: "Incorrect document content for mime_type: foo"
details {
  [type.googleapis.com/google.rpc.ErrorInfo] {
    reason: "INCORRECT_DOCUMENT_MIME_TYPE"
    domain: "documentai.googleapis.com"
    metadata { key: "mime_type" value: "foo" }
  }
}

Nenhuma página

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

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 lista um valor negativo para um dos números de página.

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ágina duplicados

Quando um documento lista 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 máximo do número total de páginas de um documento é excedido. Esse erro ocorre durante a importação ou previsão de um conjunto de dados quando um documento no conjunto de dados tem muitas 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" }
  }
}

Mudança de estado da versão do processador pré-treinado

Quando uma solicitação para mudar o estado de uma versão de processador pré-treinada foi emitida. Esse erro ocorre ao tentar excluir uma versão de processador pré-treinada.

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 de conjuntos de dados

Quando um conjunto de dados não atende aos critérios de validação, por exemplo, devido a âncoras de página ausentes, 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 do Human in the Loop para revisão

Quando uma revisão humana foi iniciada 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 um documento com um formato de arquivo não compatível ou malformado é referenciado, como .mp4.

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 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 documento inválido

Quando um intervalo de documento inválido, como o início após o fim, é fornecido.

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 um documento que inclui UTF-8 inválido é fornecido.

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 de 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 tem suporte

Quando uma solicitação de processamento é emitida para um processador que não oferece suporte a 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"
  }
}

Falha na pré-condição

A resolução exige algumas etapas, conforme descrito na mensagem de erro.

Chave KMS inválida

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

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

Mudança de estado do processador

Quando uma solicitação inválida para mudar o estado de um processador é emitida.

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

Mudança de estado da versão do processador

Quando uma solicitação inválida para mudar o estado de uma versão do processador é emitida.

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 uma solicitação que depende de um processador específico é emitida, 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" }
  }
}

Versão do processador não implantada

Quando uma solicitação que depende de uma versão específica do processador sendo implantada é enviado, mas o processador não é implantado.

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 padrão do processador

Quando uma solicitação que depende de uma versão padrão configurada é emitida, mas não há uma 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" }
  }
}

Remoção da versão padrão do processador

Quando uma solicitação de desimplantação ou exclusão de uma versão do processador é emitida, mas ela é configurada como a versão padrão.

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 uma solicitação que exige a inicialização de um conjunto de dados é emitida, 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 em inicialização

Quando uma solicitação que exige que um conjunto de dados não seja inicializado é emitida, mas o conjunto já foi inicializado ou está sendo 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 local do conjunto de dados não vazio

Quando uma solicitação exige que um local de armazenamento de conjunto de dados esteja vazio, 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"
  }
}

Apresenta erro de operação de bloqueio

Quando há outras operações em execução que estão bloqueando 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 sem suporte

Quando o campo page_range não é aceito em alguma operação, como em um 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 ausente

Quando não é possível buscar 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 da página do conjunto de dados excedido

Quando o limite total de páginas de um conjunto de dados é 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"
  }
}

Não encontrado

A resolução exige algumas etapas, 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 um documento necessário para uma operação não pode ser encontrado.

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

Job de rotulagem de dados não encontrado

Quando não é possível encontrar um job de rotulagem de dados.

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

Já existe

A resolução exige algumas etapas, conforme descrito na mensagem de erro.

O identificador human in the loop já existe

Ao criar um pool de rotuladores que já existe.

message: "The labeler pool already exists."

Cotas e limites

A resolução exige algumas etapas, conforme descrito na mensagem de erro.

Cota excedida

Se você recebeu esta mensagem:

RESOURCE_EXHAUSTED: Quota exceeded.

Você atingiu o limite de sua cota diária ou por minuto. Revise as cotas e limites para usar a Document AI.

Solicite um aumento das suas cotas pelo Console do Google Cloud.

Interrupções e latência

A resolução exige algumas etapas, conforme descrito na mensagem de erro.

Tempo limite

Para o Processamento on-line, há um tempo limite de dois minutos para solicitações do lado do servidor.
No Processamento em lote, há um tempo limite de dois minutos no servidor para gerar a operação de longa duração, mas não há tempo limite para a conclusão do job em lote.
- Para mais informações, consulte a documentação Operações de longa duração.

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

Se você receber as mensagens de erro a seguir (ou semelhantes) ao consultar 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.

O valor do tempo limite definido pelo usuário para a conclusão da operação é muito baixo para o documento que está sendo processado. Esse erro não indica que a operação do processo em lote falhou. A operação vai continuar, independentemente do valor de tempo limite definido pelo usuário.

Como receber suporte

Suspensões de uso