Method: files.asyncBatchAnnotate

Executar detecção e anotação assíncronas de imagens em uma lista de arquivos genéricos, como arquivos PDF, que podem conter várias páginas e diversas imagens por página. O progresso e os resultados podem ser recuperados na 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 assíncrona de arquivo 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. Os metadados, como formato, e o local pretendido para a saída.

InputConfig

Os metadados e o local pretendido para a entrada.

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

object(GcsSource)

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

mimeType

string

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

GcsSource

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 aceitos no momento.

OutputConfig

Os metadados e o local pretendido para a saída.

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, cinco arquivos JSON, cada um com 20 protos de resposta, serão gravados com o prefixo gcsDestination.uri.

No momento, batchSize só se aplica a 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 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 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 houver várias saídas, cada resposta ainda será AnnotationFileResponse e cada uma conterá um subconjunto da lista completa de AnnotateImageResponse. Pode haver várias saídas se, por exemplo, o JSON de saída for muito grande e for distribuído por vários arquivos fragmentados.