Messages d'erreur

Découvrez comment résoudre certaines erreurs générées par Document AI. Cette rubrique traite des erreurs dont la résolution nécessite un nombre d'étapes ne pouvant pas être indiqué facilement dans un message d'erreur.

Consultez la documentation de l'API Cloud pour connaître les bonnes pratiques de gestion des exceptions.

Autorisations

Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.

Les identifiants par défaut de l'application ne sont pas disponibles

Si vous recevez ce message :

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 utilise les identifiants par défaut de l'application pour l'authentification.

Vous devez disposer d'un compte de service pour votre projet, télécharger la clé (fichier JSON) de votre compte de service dans votre environnement de développement, puis définir l'emplacement de ce fichier JSON sur une variable d'environnement nommée GOOGLE_APPLICATION_CREDENTIALS.

En outre, la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS doit être disponible dans le contexte d'appel de l'API Document AI. Par exemple, si vous définissez la variable à partir d'une session de terminal, mais exécutez le code dans le débogueur de votre IDE, le contexte d'exécution du code peut ne pas avoir accès à la variable. Dans ce cas, la requête à Document AI pourrait échouer faute d'authentification appropriée.

Pour en savoir plus sur la définition de la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS, consultez le guide de démarrage rapide Document AI ou la documentation sur l'utilisation des identifiants par défaut de l'application.

Autorisation refusée

Si vous recevez ce message :

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

Vérifiez que vous disposez d'un fichier JSON de clé de compte de service valide à l'emplacement stocké dans la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS et que cette dernière pointe vers l'emplacement approprié.

Pour diagnostiquer cette erreur, essayez d'ouvrir le fichier de clé du compte de service depuis le dossier à partir duquel vous tentez d'appeler l'API Document AI.

cat $GOOGLE_APPLICATION_CREDENTIALS

"Interdit : 403 La méthode POST de l'API n'est pas utilisée ou est désactivée"

Si vous recevez le message suivant :

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. Utilisez le lien indiqué dans le message d'erreur et activez l'API Document AI. Patientez quelques minutes, puis réessayez.
  2. Vérifiez que vous disposez d'un fichier JSON de clé de compte de service valide stocké dans la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS. Pour diagnostiquer cette erreur, essayez d'ouvrir le fichier de clé du compte de service depuis le dossier à partir duquel vous tentez d'appeler l'API Document AI.
    cat $GOOGLE_APPLICATION_CREDENTIALS
    

Erreur lors de l'écriture du résultat final

Si vous recevez un message semblable à celui-ci lorsque vous recevez les résultats d'une requête de traitement par lot :

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

Il est possible que votre compte de service ne dispose pas des autorisations nécessaires pour créer des objets dans votre bucket Cloud Storage. Assurez-vous d'avoir attribué les autorisations appropriées à votre compte de service, comme décrit dans le guide de démarrage rapide.

Il est également possible que vous ayez mal orthographié le nom de votre bucket Cloud Storage. Vérifiez que le bucket auquel vous essayez d'accéder existe.

P4SA n'a pas accès à Cloud Storage

Lorsque le compte de service Document AI par produit (P4SA) n'est pas autorisé à accéder à certaines ressources Cloud Storage.

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

Le compte de service ne peut pas créer d'objet dans Cloud Storage

Lorsque le compte de service par produit (P4SA) Document AI n'est pas autorisé à créer un objet dans 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."

Il est possible que le compte de service Document AI ne dispose pas des autorisations nécessaires pour créer des objets dans votre bucket Cloud Storage. Assurez-vous d'avoir attribué les autorisations appropriées au compte de service Document AI, comme décrit dans la configuration de l'accès aux fichiers entre projets.

Il est également possible que vous ayez mal orthographié le nom de votre bucket Cloud Storage. Vérifiez que le bucket auquel vous essayez d'accéder existe.

L'appelant ne peut pas obtenir d'objets dans Cloud Storage

Lorsque l'appelant de l'API Document AI n'est pas autorisé à obtenir des objets dans Cloud Storage.

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

Il se peut que l'appelant de l'API ne dispose pas des autorisations nécessaires pour obtenir des objets dans votre bucket Cloud Storage. Assurez-vous d'avoir attribué les autorisations appropriées à l'appelant.

Il est également possible que vous ayez mal orthographié le nom de votre bucket Cloud Storage. Vérifiez que le bucket auquel vous essayez d'accéder existe.

Arguments non valides

Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.

Version de l'API non compatible

Lorsqu'une requête est envoyée à une version d'API qui ne prend pas en charge l'opération.

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

Type de processeur non compatible

Lorsqu'une requête est envoyée à une méthode d'API qui ne prend pas en charge le type de processeur donné.

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

Requête incorrecte

Lorsqu'une requête API est envoyée, mais que les champs de la requête comportent une ou plusieurs infractions. Chaque cas de non-respect est enregistré en tant que field_violations dans les détails de google.rpc.BadRequest.

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

Échec du traitement par lot de tous les documents

Lorsque le traitement de chaque document d'une requête de traitement par lot échoue.

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

Aucun document

Lorsque des documents sont requis ou attendus, mais qu'aucun n'est fourni, par exemple lors de l'importation de documents par URI 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"
  }
}

Les paramètres gcsUriPrefix et gcsOutputConfig.gcsUri doivent commencer par gs:// et se terminer par une barre oblique inverse (/). Vérifiez la configuration des URI de bucket.

Exemple : gs://bucket/directory/

L'entraînement n'est pas accepté

Lorsqu'une demande d'entraînement d'une version de processeur est effectuée sur un type de processeur qui ne prend pas en charge l'entraînement.

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

Aucun document sélectionné

Lorsque des documents sont attendus, mais qu'aucun n'est sélectionné dans l'ensemble de données, par exemple lors de la création de tâches d'étiquetage de données.

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

Type de document introuvable

Lorsque la classe d'un document (comme un permis, un passeport ou une facture) ne correspond pas à la classification nécessaire pour le type de processeur. Par exemple, lorsque l'étape de classification du parseur W2 ne trouve pas d'éléments dans une facture.

Il peut également s'afficher sous la forme Couldn't preview the document: Unable to find a document of type: 'foo' dans la console Google Cloud . Ce message d'erreur s'applique aux anciens processeurs.

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

La taille limite du document a été dépassée

Lorsque la limite supérieure de la taille de fichier d'un document a été dépassée lors de l'importation d'un ensemble de données ou de l'exécution d'une prédiction.

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 documents dépassée

Lorsque la limite supérieure du nombre de documents a été dépassée.

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

Type MIME non accepté

Lorsqu'un type MIME non compatible a été fourni. Le système vérifie le format du fichier (type MIME) lorsque vous importez un ensemble de données ou effectuez un appel de prédiction. Consultez Fichiers acceptés (et Analyseur de mise en page) pour connaître les types de fichiers disponibles. Si le format de fichier n'est pas accepté, le message d'erreur suivant s'affiche :

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

Aucune page

Lorsqu'un document sans page a été fourni, mais qu'une ou plusieurs pages sont requises.

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

Numéro de page négatif

Lorsqu'un document indique une valeur négative pour l'un de ses numéros de page.

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

Numéros de page en double

Un document liste le même numéro de page une ou plusieurs fois.

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 pages dépassée

Lorsque la limite supérieure du nombre total de pages d'un document est dépassée. Cette erreur se produit lors de l'importation ou de la prédiction d'un ensemble de données lorsqu'un document de l'ensemble de données comporte trop de pages, ce qui dépasse les limites du processeur.

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

Nombre de pages dépassé en mode sans image

Cette erreur se produit lors de l'importation ou de la prédiction d'un ensemble de données lorsqu'un document de l'ensemble de données comporte trop de pages, ce qui dépasse les limites du processeur. Vous pouvez demander l'ajout de votre projet à une liste d'autorisation pour activer le mode sans images. La limite de pages passe alors à 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" }
  }
}

Changement d'état de la version du processeur pré-entraîné

Lorsqu'une demande de modification de l'état d'une version de processeur préentraînée a été émise. Cette erreur se produit lorsque vous essayez de supprimer une version de processeur préentraîné.

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

Validation de l'ensemble de données

Lorsqu'un ensemble de données ne répond pas aux critères de validation, par exemple en raison d'ancres de page manquantes, de données incorrectes ou de détails incomplets dans certains attributs de l'objet proto du document.

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

Document non intégré pour examen avec intervention humaine

Un examen manuel a été lancé pour un document qui n'a pas été défini de manière intégrée.

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

Type de document non valide

Lorsque le type de document n'est pas valide ou n'est pas accepté par le processeur. Un type de document fait référence à la catégorie du document (par exemple, W2), et non son format de fichier ou son type MIME, comme 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" }
  }
}

La portée du document est hors 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" }
  }
}

Portée du document non valide

Lorsqu'une étendue de document non valide est fournie (par exemple, lorsque le début est après la fin).

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

Document UTF-8 non valide

Lorsqu'un document contenant des caractères UTF-8 non valides est fourni.

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

Le schéma de l'ensemble de données n'est pas valide

Lorsqu'un processeur ne dispose pas d'un schéma d'union valide ou que le schéma de l'ensemble de données fourni n'est pas valide.

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 non pris en charge

Lorsqu'une demande de traitement est émise pour un processeur qui ne prend pas en charge 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"
  }
}

Configuration d'importation non valide

Lorsque la configuration d'importation n'est pas valide.

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

La version du processeur source n'est pas valide

Lorsque vous essayez d'importer une version de processeur, la version de processeur source n'est pas valide pour l'importation.

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

Taille de bloc non valide

Lorsque la configuration de la taille des blocs n'est pas valide.

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

Condition préalable non remplie

Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.

Clé KMS non valide

Lorsqu'une clé non valide (par exemple, désactivée) a été fournie.

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

Changement d'état du processeur

Lorsqu'une demande non valide de modification de l'état d'un processeur est émise.

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

Changement d'état de la version du processeur

Lorsqu'une demande non valide de modification de l'état d'une version de processeur est émise.

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

Processeur non activé

Lorsqu'une requête qui dépend d'un processeur spécifique est émise, mais que le processeur n'est pas activé.

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

Version de l'outil de traitement non déployée

Lorsqu'une requête qui dépend du déploiement d'une version spécifique du processeur est émise, mais que le processeur n'est pas déployé.

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

Version par défaut du processeur

Lorsqu'une requête qui dépend d'une version par défaut configurée est émise, mais qu'aucune version n'est configurée.

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

Supprimer la version par défaut du processeur

Lorsqu'une requête visant à annuler le déploiement ou à supprimer une version de processeur est émise, mais que celle-ci est configurée comme version par défaut.

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

Ensemble de données non initialisé

Lorsqu'une requête nécessitant l'initialisation d'un ensemble de données est émise, mais que l'ensemble de données n'est pas initialisé.

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

Ensemble de données initialisé ou en cours d'initialisation

Lorsqu'une requête nécessitant la désinitialisation d'un ensemble de données est émise, mais que l'ensemble de données est déjà initialisé ou en cours d'initialisation.

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

Erreur "L'emplacement de l'ensemble de données n'est pas vide"

Lorsqu'une requête exige qu'un emplacement de stockage d'ensemble de données soit vide, mais que le dossier contient des objets.

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

Erreur d'opération de blocage

Lorsque d'autres opérations en cours bloquent l'opération requise.

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

Erreur de plage de pages non acceptée

Lorsque le champ page_range n'est pas compatible avec une opération, par exemple dans un processus par lot.

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

Le dossier Cloud Storage contient une erreur d'ensemble de données

Lorsqu'un dossier Cloud Storage contient déjà un ensemble de données.

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

Erreur de miniature manquante

Échec de la récupération de la vignette d'un document de l'ensemble de données.

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 pages de l'ensemble de données dépassée

Lorsque la limite totale de pages d'un ensemble de données a été dépassée.

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

Processeur non compatible avec le traitement synchrone

Lorsqu'une requête est envoyée pour une version de processeur qui n'est plus compatible avec le traitement synchrone.

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

Introuvable

Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.

Évaluation introuvable

Lorsqu'aucune évaluation n'est trouvée pour une version de processeur.

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

Document introuvable

Lorsqu'un document nécessaire à une opération est introuvable.

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

Processeur introuvable

Lorsqu'un processeur nécessaire à une opération est introuvable.

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

Version du processeur introuvable

Lorsqu'une version de processeur requise pour une opération est introuvable.

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 d'étiquetage de données introuvable

Lorsqu'un job d'étiquetage de données est introuvable.

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

Version du schéma introuvable

Lorsqu'une version de schéma est introuvable.

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

Schéma introuvable

Lorsqu'un schéma est introuvable.

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

Existe déjà

Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.

Un annotateur avec intervention humaine existe déjà

Lorsque vous créez un pool d'étiqueteurs qui existe déjà.

message: "The labeler pool already exists."

Le nom à afficher de la version du schéma existe déjà

Lorsque vous créez une version de schéma avec un nom à afficher qui existe déjà.

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

Le nom à afficher du schéma existe déjà

Lorsque vous créez un schéma avec un nom à afficher qui existe déjà.

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

Quotas et limites

Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.

Quota dépassé

Si vous recevez ce message :

RESOURCE_EXHAUSTED: Quota exceeded.

Vous avez atteint votre limite de quota par minute ou par jour. Vérifiez les quotas et limites d'utilisation de Document AI.

Vous pouvez demander une augmentation de vos quotas depuis la consoleGoogle Cloud .

Indisponibilités et latence

Pour résoudre le problème, vous devez suivre quelques étapes, comme indiqué dans le message d'erreur.

Délais avant expiration

L'opération ne s'est pas terminée dans le délai imparti.

Si vous recevez les messages d'erreur suivants (ou des messages similaires) lorsque vous interrogez une opération de longue durée (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.

La valeur du délai d'expiration définie par l'utilisateur pour l'exécution de l'opération est trop faible pour le document en cours de traitement. Cette erreur n'indique pas que l'opération de traitement par lot a échoué. L'opération se poursuivra quelle que soit la valeur du délai d'inactivité définie par l'utilisateur.

Erreur du filtre de sécurité

Une erreur interne côté serveur s'est produite, car la requête ou la réponse a été bloquée par les filtres de sécurité du grand modèle de langage (LLM). Vous ne pouvez pas réessayer.

message: "Safety filter error."

Erreur interne

Une erreur interne du serveur s'est produite. Effectuer une nouvelle tentative de connexion.

message: "Internal error encountered."