Se usó la API de Cloud Translation para traducir esta página.

Mensajes de error

Aprende a solucionar algunos errores que genera Document AI. En este tema, se analizan errores cuyas resoluciones requieren más pasos de los que se pueden describir en un mensaje de error.

Consulta la documentación de la API de Cloud para conocer las prácticas recomendadas de manejo de errores.

Permisos

La resolución requiere que se realicen algunos pasos, como se describe en el mensaje de error.

Las credenciales predeterminadas de la aplicación no están disponibles

Si recibes este mensaje, haz lo siguiente:

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.

Document AI usa credenciales predeterminadas de la aplicación para la autenticación.

Debes tener una cuenta de servicio para tu proyecto, descargar la clave (archivo JSON) para tu cuenta de servicio en tu entorno de desarrollo y, luego, establecer la ubicación de ese archivo JSON en una variable de entorno llamada GOOGLE_APPLICATION_CREDENTIALS.

Además, la variable de entorno GOOGLE_APPLICATION_CREDENTIALS debe estar disponible dentro del contexto en que llamas a la API de Document AI. Por ejemplo, si configuras la variable a partir de una sesión de terminal, pero ejecutas tu código en el depurador del IDE, el contexto de ejecución del código podría no tener acceso a la variable. En ese caso, tu solicitud a Document AI podría fallar por falta de autenticación adecuada.

Para obtener más información sobre cómo configurar la variable de entorno GOOGLE_APPLICATION_CREDENTIALS, consulta la guía de inicio rápido de Document AI o la documentación sobre cómo usar las credenciales predeterminadas de la aplicación.

Permiso denegado

Si recibes este mensaje, haz lo siguiente:

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

Verifica que tienes un archivo JSON de clave de cuenta de servicio válido en la ubicación almacenada en la variable de entorno de GOOGLE_APPLICATION_CREDENTIALS y que la variable apunta al lugar correcto.

Para diagnosticar este error, intenta abrir el archivo de claves de la cuenta de servicio desde la carpeta desde la que intentas llamar a la API de Document AI.

cat $GOOGLE_APPLICATION_CREDENTIALS

Prohibido: 403 POST la API no se usó o está inhabilitada

Si recibes el siguiente mensaje, haz lo siguiente:

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.

Visita el vínculo especificado en el mensaje de error y habilita la API de Document AI. Espera varios minutos y vuelve a intentarlo.
Verifica que tienes un archivo JSON de clave de cuenta de servicio válido almacenado en la variable de entorno GOOGLE_APPLICATION_CREDENTIALS. Para diagnosticar este error, intenta abrir el archivo de claves de la cuenta de servicio desde la carpeta desde la que intentas llamar a la API de Document AI.
```
cat $GOOGLE_APPLICATION_CREDENTIALS
```

Error al escribir el resultado final

Si recibes un mensaje como el siguiente cuando recibes los resultados de una solicitud de proceso por lotes, haz lo siguiente:

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

Es posible que tu cuenta de servicio no tenga los permisos correctos para crear objetos en tu bucket de Cloud Storage. Asegúrate de asignar los permisos correctos a tu cuenta de servicio, como se describe en la guía de inicio rápido.

También es posible que hayas escrito mal el nombre del bucket de Cloud Storage. Verifica que exista el bucket al que intentas acceder.

P4SA no tiene acceso a Cloud Storage

Cuando la cuenta de servicio por producto (P4SA) de Document AI no tiene permiso para acceder a algunos recursos de Cloud Storage.

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

La cuenta de servicio no puede crear objetos en Cloud Storage

Cuando la cuenta de servicio por producto (P4SA) de Document AI no tiene permiso para crear objetos en 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.

Es posible que la cuenta de servicio de Document AI no tenga los permisos correctos para crear objetos en tu bucket de Cloud Storage. Asegúrate de asignar los permisos correctos a la cuenta de servicio de Document AI, como se describe en la configuración de acceso a archivos entre proyectos.

También es posible que hayas escrito mal el nombre del bucket de Cloud Storage. Verifica que exista el bucket al que intentas acceder.

El llamador no puede obtener objetos en Cloud Storage

Cuando el llamador de la API de Document AI no tiene permiso para obtener objetos en Cloud Storage.

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

Es posible que el llamador de la API no tenga los permisos correctos para obtener objetos en tu bucket de Cloud Storage. Asegúrate de asignar los permisos correctos al llamador.

También es posible que hayas escrito mal el nombre del bucket de Cloud Storage. Verifica que exista el bucket al que intentas acceder.

Argumentos no válidos

La resolución requiere que se realicen algunos pasos, como se describe en el mensaje de error.

La versión de la API no es compatible

Ejemplo: Cuando se realiza una solicitud a una versión de la API que no admite la operación.

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

Solicitud incorrecta

Cuando se realiza una solicitud a la API, pero los campos de la solicitud tienen uno o más incumplimientos. Cada infracción se captura como un field_violations en los detalles de google.rpc.BadRequest.

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

No se pudo procesar por lotes todos los documentos

Cuando no se puede procesar ningún documento de una solicitud de procesamiento por lotes.

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

No se encontraron documentos

Cuando se requieren o esperan documentos, pero no se proporciona ninguno, como cuando se importan documentos por URI de 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"
  }
}

Los parámetros gcsUriPrefix y gcsOutputConfig.gcsUri deben comenzar con gs:// y terminar con un carácter de barra invertida al final (/). Verifica la configuración de los URIs de bucket.

Ejemplo: gs://bucket/directory/

No se admite el entrenamiento

Cuando se realiza una solicitud de versión del procesador de entrenamiento en un tipo de procesador que no admite el entrenamiento.

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

No se seleccionó ningún documento

Cuando se esperan documentos, pero no se selecciona ninguno en el conjunto de datos, como cuando se crean tareas de etiquetado de datos.

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

No se encontró el tipo de documento

Cuando la clase de un documento (como una licencia, un pasaporte o una factura) no coincide con la clasificación necesaria para el tipo de procesador. Un ejemplo es cuando el paso del clasificador en el analizador W2 no encuentra elementos de una factura.

También puede aparecer como Couldn't preview the document: Unable to find a document of type: 'foo' en la consola de Google Cloud. Este mensaje de error se aplica a los procesadores heredados.

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

Se superó el límite de tamaño del documento

Cuando se supera el límite superior del tamaño de archivo de un documento mientras se importa un conjunto de datos o se ejecuta una predicción.

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

Se superó el límite de documentos

Cuando se supera el límite superior del recuento de documentos.

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 de MIME no compatible

Cuando se proporcionó un tipo de MIME no admitido. El sistema verifica el formato del archivo (tipo MIME) cuando importas un conjunto de datos y cuando realizas una llamada de predicción. Si el formato de archivo no es compatible, verás el siguiente mensaje de error:

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 de MIME de documento incorrecto

Cuando el contenido del documento no coincide con el tipo de MIME especificado. El sistema verifica el formato de archivo (tipo MIME) cuando importas un conjunto de datos y cuando realizas una llamada de predicción. Si el formato de archivo que proporcionas no coincide con el formato esperado, aparecerá el siguiente mensaje de error:

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

No hay páginas

Cuando se proporciona un documento sin páginas, pero se requieren una o más.

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

Cuando un documento muestra un valor negativo para uno de sus 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

Cuando un documento incluye el mismo número de página una o más veces.

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

Se superó el límite de páginas

Cuando se supera el límite superior de la cantidad total de páginas de un documento. Te encuentras con este error durante la importación o la predicción de conjuntos de datos cuando un documento dentro del conjunto de datos tiene demasiadas páginas, lo que supera los límites del procesador.

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

Cambio de estado de la versión del procesador previamente entrenado

Cuando se emitió una solicitud para cambiar el estado de una versión de procesador previamente entrenada. Este error se produce cuando intentas borrar una versión de procesador previamente entrenada.

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

Validación de conjuntos de datos

Cuando un conjunto de datos no cumple con los criterios de validación, por ejemplo, debido a que faltan anclas de página, datos incorrectos o detalles incompletos en algunos atributos del objeto proto del 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 no intercalado de revisión manual

Cuando se inició una revisión manual de un documento que no se definió intercalado.

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 no válido

Cuando se hace referencia a un documento con un formato de archivo no compatible o con un formato incorrecto, 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" }
  }
}

El intervalo del documento está fuera de los límites

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 no válido

Cuando se proporciona un intervalo de documentos no válido, por ejemplo, el inicio es posterior al final.

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 no válido

Cuando se proporciona un documento que incluye UTF-8 no vá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)" }
  }
}

El esquema del conjunto de datos no es válido

Cuando un procesador no tiene un esquema de unión válido o el esquema de conjunto de datos proporcionado no es 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 no es compatible

Cuando se emite una solicitud de procesamiento para un procesador que no es compatible con 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"
  }
}

Configuración de importación no válida

Cuando la configuración de importación no es válida.

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

La versión del procesador de origen no es válida

Cuando se intenta importar una versión de procesador, la versión del procesador de origen no es válida para importarse.

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

Precondición con errores

La resolución requiere que se realicen algunos pasos, como se describe en el mensaje de error.

Clave de KMS no válida

Cuando se proporcionó una clave no válida (p.ej., está inhabilitada).

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

Cambio de estado del procesador

Cuando se emite una solicitud no válida para cambiar el estado de un procesador.

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

Cambio de estado de la versión del procesador

Cuando se emite una solicitud no válida para cambiar el estado de una versión de procesador.

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

El procesador no está habilitado

Cuando se emite una solicitud que depende de un procesador específico, pero este no está habilitado.

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

No se implementó la versión del procesador

Ocurre cuando se emite una solicitud que depende de una versión específica del procesador que se está implementando, pero el procesador no se implementa.

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

Versión predeterminada del procesador

Cuando se emite una solicitud que depende de la configuración de una versión predeterminada, pero no hay una 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" }
  }
}

El procesador quita la versión predeterminada

Cuando se emite una solicitud para anular la implementación o borrar una versión del procesador, pero está configurada como la versión predeterminada.

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

El conjunto de datos no se inicializó

Cuando se emite una solicitud que requiere que se inicialice un conjunto de datos, pero este no se inicializó.

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

Conjunto de datos inicializado o en proceso de inicialización

Cuando se emite una solicitud que requiere que un conjunto de datos no se inicialice, pero el conjunto de datos ya se inicializó o se está inicializando.

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

Error de ubicación del conjunto de datos no vacía

Cuando una solicitud requiere que una ubicación de almacenamiento de conjunto de datos esté vacía, pero la carpeta contiene 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"
  }
}

Tiene un error de operación de bloqueo

Cuando hay otras operaciones en ejecución que bloquean la operación requerida.

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

Error de intervalo de páginas no admitido

Cuando el campo page_range no es compatible con alguna operación, como en un proceso por lotes.

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

La carpeta de Cloud Storage contiene un error de conjunto de datos

Cuando una carpeta de Cloud Storage ya contiene un conjunto de datos.

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

Error de miniatura faltante

Cuando no se puede recuperar la miniatura de un documento de conjunto de datos.

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

Se excedió el límite de páginas del conjunto de datos

Cuando se supera el límite total de páginas de un conjunto de datos.

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

No encontrado

La resolución requiere que se realicen algunos pasos, como se describe en el mensaje de error.

No se encontró la evaluación

Cuando no se puede encontrar una evaluación para una versión de procesador.

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

No se encontró el documento

Cuando no se puede encontrar un documento necesario para una operación.

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

No se encontró el procesador

Cuando no se puede encontrar un procesador necesario para una operación.

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

No se encontró la versión del procesador

Cuando no se puede encontrar una versión de procesador necesaria para una operación.

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

No se encontró el trabajo de etiquetado de datos

Cuando no se puede encontrar un trabajo de etiquetado de datos.

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

Ya existe

La resolución requiere que se realicen algunos pasos, como se describe en el mensaje de error.

Ya existe un etiquetador con interacción humana

Cuando se crea un grupo de etiquetadores que ya existe.

message: "The labeler pool already exists."

Cuotas y límites

La resolución requiere que se realicen algunos pasos, como se describe en el mensaje de error.

Se superó la cuota

Si recibes este mensaje, haz lo siguiente:

RESOURCE_EXHAUSTED: Quota exceeded.

Alcanzaste el límite de tu cuota diaria o por minuto. Revisa las cuotas y límites para usar Document AI.

Puedes solicitar un aumento de las cuotas desde la consola de Google Cloud.

Interrupciones y latencia

La resolución requiere que se realicen algunos pasos, como se describe en el mensaje de error.

Tiempos de espera

Para el procesamiento en línea, hay un tiempo de espera de 2 minutos del servidor para las solicitudes.
En el caso del procesamiento por lotes, hay un tiempo de espera de 2 minutos del servidor para generar la operación de larga duración, pero no hay un tiempo de espera para completar el trabajo por lotes.
- Para obtener más información, consulta la documentación sobre Operaciones de larga duración.

La operación no se completó dentro del tiempo de espera designado.

Si recibes los siguientes mensajes de error (o similares) cuando sondeas una operación de larga duración (LRO), haz lo siguiente:

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.

Luego, el valor de tiempo de espera establecido por el usuario para completar la operación es demasiado bajo para el documento que se está procesando. Este error no indica que la operación del proceso por lotes falló. La operación continuará independientemente del valor de tiempo de espera establecido por el usuario.

Obtén asistencia

Bajas