Method: files.asyncBatchAnnotate

Ejecuta la detección y anotación asíncrona de imágenes para obtener una lista de archivos genéricos, como archivos PDF, que pueden contener varias páginas y varias imágenes por página. El progreso y los resultados se pueden recuperar mediante la interfaz google.longrunning.Operations. Operation.metadata contiene OperationMetadata (metadatos). Operation.response contiene AsyncBatchAnnotateFilesResponse (resultados).

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "requests": [
    {
      object(AsyncAnnotateFileRequest)
    }
  ]
}
Campos
requests[]

object(AsyncAnnotateFileRequest)

Solicitudes de anotaciones de archivos asíncronos individuales para este lote.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

AsyncAnnotateFileRequest

Una solicitud de anotación de archivos sin conexión.

Representación JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "outputConfig": {
    object(OutputConfig)
  }
}
Campos
inputConfig

object(InputConfig)

Obligatorio. Información sobre el archivo de entrada.

features[]

object(Feature)

Obligatorio. Funciones solicitadas.

imageContext

object(ImageContext)

Contexto adicional, que puede acompañar a las imágenes en el archivo.

outputConfig

object(OutputConfig)

Obligatorio. La ubicación de salida y los metadatos deseados (p. ej., el formato).

InputConfig

La ubicación y los metadatos de entrada deseados.

Representación JSON 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
Campos
gcsSource

object(GcsSource)

La ubicación de Google Cloud Storage desde la que se lee la entrada.

mimeType

string

El tipo de archivo. Actualmente, solo se admiten "application/pdf" e "image/tiff". Los comodines no son compatibles.

GcsSource

La ubicación de Google Cloud Storage desde la que se leerá la entrada.

Representación JSON 
{
  "uri": string
}
Campos
uri

string

URI de Google Cloud Storage para el archivo de entrada. Este solo debe ser un objeto de Google Cloud Storage. Por el momento, no se admiten los comodines.

OutputConfig

La ubicación de salida y los metadatos deseados.

Representación JSON 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
Campos
gcsDestination

object(GcsDestination)

La ubicación de Google Cloud Storage en la que se escriben los resultados.

batchSize

number

La cantidad máxima de protos de respuesta que se deben colocar en cada archivo JSON de salida en Google Cloud Storage. El rango válido es [1, 100]. Si no se especifica, el valor predeterminado es 20.

Por ejemplo, en un archivo PDF con 100 páginas, se generarán 100 archivos .proto de respuesta. Si batchSize = 20, se escribirán 5 archivos json, cada uno con 20 .proto de respuesta, con el prefijo gcsDestination.uri.

Actualmente, batchSize solo se aplica a GcsDestination, y es posible que se admita otra configuración de salida en el futuro.

GcsDestination

La ubicación de Google Cloud Storage en la que se escribe el resultado.

Representación JSON 
{
  "uri": string
}
Campos
uri

string

URI de Google Cloud Storage donde se almacenarán los resultados. Los resultados estarán en formato JSON y precedidos por el URI de entrada correspondiente Este campo puede representar un solo archivo o un prefijo para varias salidas Los prefijos deben terminar en /.

Ejemplos:

Si hay varios resultados, cada respuesta sigue siendo AnnotateFileResponse, cada una de las cuales contiene algún subconjunto de la lista completa de AnnotateImageResponse. Es posible que se produzcan varios resultados si, por ejemplo, el resultado de JSON es demasiado grande y se desborda en varios archivos fragmentados.