Method: files.annotate

Serviço que realiza a deteção e a anotação de imagens para um lote de ficheiros. Agora, apenas são suportados os tipos "application/pdf", "image/tiff" e "image/gif".

Este serviço extrai, no máximo, 5 frames (GIF) ou páginas (PDF ou TIFF) de cada ficheiro fornecido e realiza a deteção e a anotação de cada imagem extraída. Os clientes podem especificar que 5 frames ou páginas querem no AnnotateFileRequest.pages.

Pedido HTTP

POST https://vision.googleapis.com/v1p4beta1/files:annotate

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

Corpo do pedido

O corpo do pedido contém dados com a seguinte estrutura:

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

object (AnnotateFileRequest)

A lista de pedidos de anotação de ficheiros. Atualmente, só suportamos um AnnotateFileRequest em BatchAnnotateFilesRequest.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém dados com a seguinte estrutura:

Uma lista de respostas de anotações de ficheiros.

Representação JSON 
{
  "responses": [
    {
      object (AnnotateFileResponse)
    }
  ]
}
Campos
responses[]

object (AnnotateFileResponse)

A lista de respostas de anotação de ficheiros, cada resposta correspondente a cada AnnotateFileRequest em BatchAnnotateFilesRequest.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte a Vista geral da autenticação.

AnnotateFileRequest

Um pedido para anotar um único ficheiro, por exemplo, um ficheiro PDF, TIFF ou GIF.

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

object (InputConfig)

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

features[]

object (Feature)

Obrigatório. Funcionalidades pedidas.

imageContext

object (ImageContext)

Contexto adicional que pode acompanhar as imagens no ficheiro.

pages[]

number

Páginas do ficheiro para fazer a anotação de imagens.

As páginas começam a partir de 1. Presumimos que a primeira página do ficheiro é a página 1. São suportadas, no máximo, 5 páginas por pedido. As páginas podem ser negativas.

Página 1 significa a primeira página. Página 2 significa a segunda página. A página -1 significa a última página. A página -2 significa a penúltima página.

Se o ficheiro for GIF em vez de PDF ou TIFF, a página refere-se a frames GIF.

Se este campo estiver vazio, por predefinição, o serviço realiza a anotação de imagens para as primeiras 5 páginas do ficheiro.

AnnotateFileResponse

Resposta a um pedido de anotação de um único ficheiro. Um ficheiro pode conter uma ou mais imagens, que têm individualmente as suas próprias respostas.

Representação JSON 
{
  "inputConfig": {
    object (InputConfig)
  },
  "responses": [
    {
      object (AnnotateImageResponse)
    }
  ],
  "totalPages": number
}
Campos
inputConfig

object (InputConfig)

Informações sobre o ficheiro para o qual esta resposta é gerada.

responses[]

object (AnnotateImageResponse)

Respostas individuais a imagens encontradas no ficheiro.

totalPages

number

Este campo indica o número total de páginas no ficheiro.