Mensajes de error

Consulta cómo solucionar algunos errores que genera Document AI. En este tema se tratan los errores cuya resolución requiere más pasos de los que se pueden describir en un mensaje de error.

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

Permisos

Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.

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

Si recibes este mensaje:

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 de aplicación predeterminadas para la autenticación.

Debes tener una cuenta de servicio para tu proyecto, descargar la clave (archivo JSON) de tu cuenta de servicio en tu entorno de desarrollo y, a continuación, definir 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 en el contexto en el que llames a la API Document AI. Por ejemplo, si defines la variable desde una sesión de terminal, pero ejecutas el código en el depurador de tu IDE, es posible que el contexto de ejecución del código no tenga acceso a la variable. En ese caso, es posible que tu solicitud a Document AI falle por falta de autenticación adecuada.

Para obtener más información sobre cómo definir 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:

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

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

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

cat $GOOGLE_APPLICATION_CREDENTIALS

Prohibido: no se ha usado la API POST 403 o está inhabilitada

Si recibes el mensaje:

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. Visita el enlace especificado en el mensaje de error y habilita la API Document AI. Espera varios minutos y vuelve a intentarlo.
  2. Comprueba 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, prueba a abrir el archivo de clave de cuenta de servicio desde la carpeta desde la que intentas llamar a la API Document AI.
    cat $GOOGLE_APPLICATION_CREDENTIALS
    

Error al escribir la salida final

Si recibes un mensaje como el siguiente al recibir los resultados de una solicitud de proceso por lotes:

{
  "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 segmento de Cloud Storage. Asegúrate de haber asignado los permisos correctos a tu cuenta de servicio, tal como se describe en la guía de inicio rápido.

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

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 adecuados para crear objetos en tu segmento de Cloud Storage. Asegúrate de haber asignado los permisos correctos a la cuenta de servicio de Document AI, tal como se describe en la configuración de acceso a archivos entre proyectos.

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

El llamador no puede obtener objetos de Cloud Storage

Cuando el llamante 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 llamante de la API no tenga los permisos correctos para obtener objetos de tu segmento de Cloud Storage. Asegúrate de haber asignado los permisos correctos a la persona que llama.

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

Argumentos no válidos

Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.

Versión de la API no compatible

Cuando se hace 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."

Tipo de procesador no admitido

Cuando se hace una solicitud a un método de API que no admite el tipo de procesador proporcionado.

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

Bad Request

Cuando se envía una solicitud a la API, pero los campos de la solicitud tienen una o varias infracciones. Cada infracción se registra como un field_violations en los google.rpc.BadRequest detalles.

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

No se ha podido 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"
  }
}

Ningún documento coincide con la búsqueda

Cuando se requieren o se esperan documentos, pero no se proporciona ninguno, como cuando se importan documentos mediante un 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 empezar por gs:// y terminar con una barra invertida (/). Comprueba la configuración de los URIs del segmento.

Ejemplo: gs://bucket/directory/

No se admite la formación

Cuando se hace 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 ha seleccionado 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 ha encontrado el tipo de documento

Cuando la clase de un documento (como un carné de conducir, un pasaporte o una factura) no coincide con la clasificación necesaria para el tipo de procesador. Por ejemplo, cuando el paso del clasificador en el analizador de 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 Google Cloud consola. Este mensaje de error se aplica a los procesadores antiguos.

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 ha superado el límite de tamaño del documento

Cuando se supera el límite superior del tamaño de archivo de un documento al importar un conjunto de datos o al ejecutar 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 ha superado el límite de documentos

Cuando se ha superado el límite superior del número 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 MIME no admitido

Cuando se ha proporcionado un tipo de MIME no admitido. El sistema verifica el formato de archivo (tipo MIME) cuando importas un conjunto de datos o haces una llamada de predicción. Ve a Archivos admitidos (y a Analizador de diseño) para ver los tipos de archivo disponibles. Si el formato de archivo no es compatible, verás el siguiente mensaje de error:

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

No hay páginas

Cuando se ha proporcionado un documento sin páginas, pero se requieren una o varias 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

Cuando un documento indica 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 varias 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 ha superado el límite de páginas

Cuando se supera el límite superior del número total de páginas de un documento. Este error se produce durante la importación o la predicción de un conjunto de datos cuando un documento 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" }
  }
}

Se ha superado el límite de páginas en el modo sin imágenes

Este error se produce durante la importación de un conjunto de datos o la predicción cuando un documento del conjunto de datos tiene demasiadas páginas, lo que supera los límites del procesador. Puedes solicitar que tu proyecto se añada a una lista de permitidas para habilitar el modo sin imágenes, lo que aumenta el límite de páginas a 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" }
  }
}

Cambio de estado de la versión de un procesador preentrenado

Cuando se emitió una solicitud para cambiar el estado de una versión de procesador preentrenada. Este error se produce al intentar eliminar una versión de un procesador preentrenado.

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 los criterios de validación, por ejemplo, porque faltan anclas de página, los datos son incorrectos o los detalles de algunos atributos del objeto proto del documento están incompletos.

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

Documento sin insertar con intervención humana para su revisión

Cuando se ha iniciado una revisión humana de un documento que no se ha definido de forma insertada.

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 el tipo de documento no es válido o no es compatible con el procesador. Un tipo de documento hace referencia a la categoría del documento (por ejemplo, W2), no su formato de archivo o tipo MIME, como PDF o 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" }
  }
}

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

Cuando se proporciona un intervalo de documento no válido, como cuando 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 caracteres UTF-8 no válidos.

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 Unsupported

Cuando se emite una solicitud de procesamiento para un procesador que no admite 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

Al intentar importar una versión del 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"
  }
}

Tamaño de fragmento no válido

Cuando la configuración del tamaño del fragmento no es vá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"
  }
}

No se cumple la condición previa

Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.

Clave KMS no válida

Cuando se ha proporcionado una clave no válida (por ejemplo, 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 envía 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" }
  }
}

Procesador no habilitado

Cuando se emite una solicitud que depende de un procesador específico, pero el procesador 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" }
  }
}

Versión del procesador no implementada

Cuando se envía una solicitud que depende de que se haya implementado una versión específica del procesador, pero el procesador no se ha 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" }
  }
}

Versión predeterminada del procesador

Cuando se envía una solicitud que depende de que se haya configurado una versión predeterminada, pero no se ha configurado ninguna.

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

Processor remove default version

Cuando se envía una solicitud para retirar o eliminar una versión de un procesador, pero esta se ha configurado 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" }
  }
}

Conjunto de datos no inicializado

Cuando se envía una solicitud que requiere que se inicialice un conjunto de datos, pero no se ha inicializado.

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 envía una solicitud que requiere que un conjunto de datos no esté inicializado, pero el conjunto de datos ya está inicializado 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 Dataset Location Not Empty

Cuando una solicitud requiere que la ubicación de almacenamiento de un 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"
  }
}

Has Blocking Operation Error

Cuando hay otras operaciones en curso que bloquean la operación necesaria.

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 se admite en 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 en el 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 falta de miniatura

Cuando no se puede obtener 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 ha superado el límite de páginas del conjunto de datos

Cuando se ha superado 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"
  }
}

Procesador no admitido para el procesamiento síncrono

Cuando se hace una solicitud para una versión del procesador que ya no se admite para el procesamiento 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"
  }
}

No se ha encontrado

Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.

No se ha encontrado la evaluación

Cuando no se encuentra una evaluación de una versión del 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" }
  }
}

Documento no encontrado

Cuando no se encuentra 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 ha encontrado el procesador

Cuando no se encuentra 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 ha encontrado la versión del procesador

Cuando no se encuentra una versión del 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 ha encontrado la tarea de etiquetado de datos

Cuando no se encuentra una tarea de etiquetado de datos.

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

No se ha encontrado la versión del esquema

Cuando no se encuentra una versión del esquema.

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

No se ha encontrado el esquema

Cuando no se encuentra un esquema.

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

Ya existe

Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.

Ya existe un etiquetador con intervención humana

Cuando se crea un grupo de etiquetadores que ya existe.

message: "The labeler pool already exists."

El nombre visible de la versión del esquema ya existe

Cuando se crea una versión de un esquema con un nombre visible que ya existe.

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

El nombre visible del esquema ya existe

Cuando se crea un esquema con un nombre visible que ya existe.

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

Cuotas y límites

Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.

Se ha superado la cuota

Si recibes este mensaje:

RESOURCE_EXHAUSTED: Quota exceeded.

Has alcanzado el límite de tu cuota por minuto o diaria. Consulta las cuotas y los límites de uso de Document AI.

Puedes solicitar que te aumentemos las cuotas desde la Google Cloud consola.

Interrupciones y latencia

Para solucionarlo, debes seguir los pasos que se indican en el mensaje de error.

Tiempos de espera

La operación no se ha completado en el tiempo de espera designado.

Si recibes los siguientes mensajes de error (o similares) al sondear una operación de larga duración (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.

A continuación, el valor de tiempo de espera definido 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 haya fallado. La operación continuará independientemente del valor de tiempo de espera definido por el usuario.

Error del filtro de seguridad

Se ha producido un error interno del lado del servidor porque los filtros de seguridad del modelo de lenguaje extenso (LLM) han bloqueado la solicitud o la respuesta. Este error no se puede volver a intentar.

message: "Safety filter error."

Error interno

Se ha producido un error interno del lado del servidor. Vuelve a intentar la conexión.

message: "Internal error encountered."