Method: files.asyncBatchAnnotate

Détecte et annote de manière asynchrone les images d'une liste de fichiers génériques, tels que des fichiers PDF, qui peuvent contenir plusieurs pages et plusieurs images par page. La progression et les résultats peuvent être récupérés par le biais de l'interface google.longrunning.Operations. Operation.metadata contient OperationMetadata (métadonnées). Operation.response contient AsyncBatchAnnotateFilesResponse (résultats).

Requête HTTP

POST https://vision.googleapis.com/v1p3beta1/files:asyncBatchAnnotate

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "requests": [
    {
      object(AsyncAnnotateFileRequest)
    }
  ]
}
Champs
requests[]

object(AsyncAnnotateFileRequest)

Requêtes d'annotation de fichiers asynchrones individuelles du lot.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-vision

Pour en savoir plus, consultez Présentation de l'authentification.

AsyncAnnotateFileRequest

Requête d'annotation de fichiers hors connexion.

Représentation JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "outputConfig": {
    object(OutputConfig)
  }
}
Champs
inputConfig

object(InputConfig)

Obligatoire. Informations sur le fichier d'entrée.

features[]

object(Feature)

Obligatoire. Fonctionnalités demandées.

imageContext

object(ImageContext)

Contexte supplémentaire pouvant accompagner les images du fichier.

outputConfig

object(OutputConfig)

Obligatoire. Emplacement de sortie et métadonnées (par exemple, le format) souhaités.

InputConfig

Emplacement d'entrée et métadonnées souhaités.

Représentation JSON 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
Champs
gcsSource

object(GcsSource)

Emplacement Google Cloud Storage à partir duquel lire l'entrée.

mimeType

string

Type de fichier. Actuellement, seuls les fichiers "application/pdf" et "image/tiff" sont acceptés. Les caractères génériques ne peuvent pas être utilisés.

GcsSource

Emplacement Google Cloud Storage dans lequel l'entrée est lue.

Représentation JSON 
{
  "uri": string
}
Champs
uri

string

URI Google Cloud Storage du fichier d'entrée. Il ne peut s'agir que d'un objet Google Cloud Storage. Les caractères génériques ne sont pas acceptés pour le moment.

OutputConfig

Emplacement de sortie et métadonnées souhaités.

Représentation JSON 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
Champs
gcsDestination

object(GcsDestination)

Emplacement Google Cloud Storage dans lequel écrire les sorties.

batchSize

number

Nombre maximal de fichiers .proto de réponse à placer dans chaque fichier JSON de résultat dans Google Cloud Storage. La plage valide est [1, 100]. Si aucune valeur n'est spécifiée, la valeur par défaut est 20.

Par exemple, pour un fichier PDF de 100 pages, 100 fichiers .proto de réponse sont générés. Si le champ batchSize est égal à 20, 5 fichiers JSON contenant chacun 20 fichiers .proto de réponse sont écrits sous le préfixe gcsDestination.uri.

Actuellement, le champ "batchSize" ne s'applique qu'à l'emplacement GcsDestination. Il est possible qu'il soit prochainement compatible avec d'autres configurations de sortie.

GcsDestination

Emplacement Google Cloud Storage sur lequel le résultat doit être écrit.

Représentation JSON 
{
  "uri": string
}
Champs
uri

string

URI Google Cloud Storage où seront stockés les résultats. Les résultats sont au format JSON et précédés de l'URI d'entrée correspondant. Ce champ peut représenter un seul fichier ou un préfixe pour plusieurs sorties. Les préfixes doivent se terminer par /.

Exemples :

Si plusieurs sorties existent, toutes les réponses contiennent "AnnotateFileResponse", chacune incluant un sous-ensemble de la liste complète d'AnnotateImageResponse. Plusieurs sorties peuvent être générées si, par exemple, la sortie JSON est trop volumineuse et qu'elle est répartie en plusieurs fichiers segmentés.