Method: files.asyncBatchAnnotate

Execute a detecção e anotação de imagem assíncrona para obter uma lista de arquivos genéricos, como arquivos PDF, que podem conter várias páginas e várias imagens por página. O progresso e os resultados podem ser recuperados por meio da interface google.longrunning.Operations Operation.metadata contém OperationMetadata (metadados). Operation.response contém AsyncBatchAnnotateFilesResponse (resultados).

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "requests": [
    {
      object(AsyncAnnotateFileRequest)
    }
  ]
}
Campos
requests[]

object(AsyncAnnotateFileRequest)

Solicitações individuais de anotação de arquivo assíncrono para este lote.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

AsyncAnnotateFileRequest

Uma solicitação de anotação de arquivo off-line.

Representação JSON 
{
  "inputConfig": {
    object(InputConfig)
  },
  "features": [
    {
      object(Feature)
    }
  ],
  "imageContext": {
    object(ImageContext)
  },
  "outputConfig": {
    object(OutputConfig)
  }
}
Campos
inputConfig

object(InputConfig)

Obrigatório. Informações sobre o arquivo de entrada.

features[]

object(Feature)

Obrigatório. Recursos solicitados.

imageContext

object(ImageContext)

Contexto adicional que pode acompanhar as imagens no arquivo.

outputConfig

object(OutputConfig)

Obrigatório. O local e os metadados da saída desejados (por exemplo, formato).

InputConfig

O local e os metadados da entrada desejados.

Representação JSON 
{
  "gcsSource": {
    object(GcsSource)
  },
  "mimeType": string
}
Campos
gcsSource

object(GcsSource)

Local do Google Cloud Storage onde será lida a entrada.

mimeType

string

O tipo do arquivo. No momento, somente "application/pdf" e "image/tiff" são compatíveis. Caracteres curinga não são aceitos.

GcsSource

O local do Google Cloud Storage em que a entrada será lida.

Representação JSON 
{
  "uri": string
}
Campos
uri

string

URI do Google Cloud Storage para o arquivo de entrada. Precisa ser apenas um objeto do Google Cloud Storage. Caracteres curinga não são compatíveis no momento.

OutputConfig

O local e os metadados da saída desejados.

Representação JSON 
{
  "gcsDestination": {
    object(GcsDestination)
  },
  "batchSize": number
}
Campos
gcsDestination

object(GcsDestination)

O local do Google Cloud Storage em que a saída será gravada.

batchSize

number

O número máximo de protos de resposta a serem colocados em cada arquivo JSON de saída no Google Cloud Storage. O intervalo válido é [1, 100]. Se não for especificado, o valor padrão será 20.

Por exemplo, para um arquivo PDF com 100 páginas, serão gerados 100 protos de resposta. Se batchSize = 20, então cinco arquivos json, cada qual contendo 20 protos de resposta, serão gravados com o prefixo gcsDestination.uri.

Atualmente, batchSize se aplica apenas ao GcsDestination, com possível suporte futuro para outras configurações de saída.

GcsDestination

O local do Google Cloud Storage em que a saída precisa ser gravada.

Representação JSON 
{
  "uri": string
}
Campos
uri

string

URI do Google Cloud Storage em que os resultados serão armazenados. Os resultados estarão no formato JSON e precedidos pelo URI de entrada correspondente. Esse campo pode representar um único arquivo ou um prefixo para várias saídas. Os prefixos precisam terminar com /.

Exemplos:

Se várias saídas, cada resposta ainda será AnnotationFileResponse, cada uma contendo um subconjunto da lista completa de AnnotateImageResponse. Várias saídas podem acontecer se, por exemplo, o JSON de saída for muito grande e transbordar em vários arquivos fragmentados.